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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide comphance to 
3GPPTS 43.019 [7]. 

The present document describes the technical characteristics and methods of test for testing the SIM API for Java 
Card™ (3GPP TS 43.019 [7]) implemented in the Subscriber Identity Modules (SIMs) for GSM. It specifies the 
following parts: 

test applicability; 

test environment description; 

tests format; 

test area reference; 

conformance requirements; 

test auite files; 

test procedure; 

test coverage; and 

a description of the associated testing tools that shall be used. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] Void. 

[2] Void. 

[3] 3GPP TS 51.01 1: "Specification of the Subscriber Identity Module - Mobile Equipment (SIM - 

ME) interface". 

[4] 3GPP TS 51.014: "Specification of the Subscriber Identity Module - Mobile Equipment (SIM - 

ME) interface". 

[5] GSM 11.17: "Digital cellular telecommunications system (Phase 2+); Subscriber Identity Module 

(SIM) test specification". 

[6] Void. 

[7] 3GPP TS 43.019: "Subscriber Identity Module Apphcation Programming Interface (SIM API) for 

Java Card™; Stage 2". 

[8] 3GPP TS 23.048: "Security Mechanisms for the (U)SIM apphcation toolkit; Stage 2 (Release 4)". 
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[9] ISO/IEC 7816-3 (1997): "Information technology - Identification cards - Integrated circuit(s) cards 

with contacts - Part 3: Electronic signals and transmission protocols". 

[10] 3GPP TS 42.019: "Subscriber Identity Module Application Programming Interface (SIM API); 

Stage 1". 

[11] SUN Java Card Specification "Java Card 2.1 API Specification". 

[12] SUN Java Card Specification "Java Card 2.1 Runtime Environment Specification". 

[13] SUN Java Card Specification "Java Card 2.1 VM Architecture Specification". 

NOTE: SUN Java Card Specifications can be downloaded at http://iava.sun.com/products/iavacard . 

[14] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers". 

[15] 3GPP TS 51.010-1: "Mobile Station (MS) conformance specification; Part 1: Conformance 

specification". 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 51.010-1 [15] and the following 
apply: 

applet: application built up using a number of classes which will run under the control of the Java Card virtual machine 

applet installation parameters: default values for applet installation parameters 

applet loading script: file containing the APDU commands that will load and install the test applet in the card 

CleanUp Script file: file containing the APDU commands that will restore the Default Initial Conditions on the SIM 

Conformance Requirement Reference: description of the expected card behaviour according to 3GPP TS 43.019 

expected state: state in which the SIM is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 

test area: set of Test Cases applicable to a specific part (class method, framework behaviour, ...) of the 
3GPPTS 43.019. 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test Output file: TBD. 

test procedure: the sequence of actions/commands to perform all the test cases defined in a test area 

test script file: file containing the APDU commands that will execute and verify the test results 

Test Toolkit Applet: applet designed to test a specific functionality of the SIM API (3GPP TS 43.019) 

3.2 Abbreviations 

For the purpose of the present document, the abbreviations given in GSM 01.04 [2] and the following apply: 

AC Application Code 

AID Application Identifier 

APDU Application Protocol Data Unit 
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API 

CAD 

CRR 

CRRC 

CRRN 

CRRP 

FFS 

IFD 

JCRE 

JVM 

SE 

SIM 



Application Programming Interface 

Card Acceptance Device 

Conformance Requirements Reference 

Conformance Requirement Reference Context Error 

Conformance Requirement Reference Normal 

Conformance Requirement Reference Parameter Error 

For Further Study 

Interface Device 

Java Card"^ Run Time Environment 

Java Virtual Machine 

Sending Entity 

Subscriber Identity Module 



Test Environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 



4.1 



Applicability 



The tests defined in the present document shall be performed taking into account the services supported by the card as 
specified in the EFsst file. 

The present document contains tests that test interoperability at the API level. The present document does not currently 
contain tests for interoperability at the SIM API framework and at the byte code level. These are for further study. 

The test defined in the present document are applicable to cards implementing 3GPP TS 43.019 [7] unless otherwise 
stated. 



4.2 Test environment description 

The general architecture for the test environment is. 
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GSM03.19and 

Java Card™ 2.1 

export files 



Test 
Toolkit 
Applet 



■^^ 



Applet 
.cap 



H 



Applet 
installation 
parameter 



^^ 



Test 
Script 



Cleanup 
Script 



TERMING 



Converter 



Loader: 

OP SMS 

formatter 



APDU 
VO 



T- 



Output 

test 
result 



Scope of the Test Suite. 
. Elements of the Test Suite 



Applet loading 
script 




NOTE: 



Figure 4.2 shows the test architecture required to test interoperability at both API and bytcode level. The 
latter is currently not included in the current specification. The diagram is for information. 

Figure 4.2 



4.3 



Tests format 



4.3.1 Test Area Reference 

Each test area is referenced as follows: 

API Testing:: 'API_[package name]_[classname]_[methodname]' where 
package name: 

sim. access package: '1' 
sim.toolkit package: '2' 
class name: 

yyy: 3 letters for each class. 
See Annex A for full classes acronyms list, 
method name: 

zzzz [input parameters]: 

See Annex A for full methods name acronyms list. 
FWK: framework testing 
Chapter name: 
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xxx: 3 letters for each chapter 

See annex F for full chapter acronyms list 
Subchapter name 

yyyy: : 4 letters for each subchapter 

See annex F for full subchapter acronyms list 
LDR: loader testing 
[TBD] 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

- Method prototype as listed in 3GPP TS 43 .0 1 9 [7] . 

Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 

4.3.1.2 Test Area files 

The files included in the Test Area use the following naming convention: 

Test Script: [Test Area Reference]_[Test script number]. scr 

Test Applet: [Test Area Reference]_[Test applet number] .Java 

Load Script: [Test Area Reference]_[Load Script number] .Idr 

Cleanup Script: [Test Area Reference]_[Cleanup Script number]. clr 

Parameter File: [Test Area Reference]_[Parameter File number] .par 

The test script, applet, installation parameters, load script, cleanup script and conversion parameters numbers start from 
'1'. 

The test script, load script and cleanup script shall share a common syntax and format (see Annex B). 

The parameter file has an own syntax (see annex G) and contains parameters to be used for CAP-file conversion and 
loading/cleanup script generation. 

Scripts file shall be run in the following order: 

[Test Area Reference]_l .Idr 

[Test Area Reference]_l.scr 

[Test Area Reference]_l.clr 

[Test Area Reference]_2.1dr 
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[Test Area Reference]_2.scr 
[Test Area Reference]_2.clr 

[Test Area Reference]_n.ldr 
[Test Area Reference]_n.scr 
[Test Area Reference]_n.clr 
In case that one of the files is not needed, it shall be skipped during the tests execution. 

4.3.1.3 Test Procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API Expectation 


APDU Expectation 




Test Case detailed description 


API expected behaviour. 


Expected response at APDU 
level. 



4.3.1 .4 Test Coverage 

The table at the end of each test procedure indicates the correspondence between the Conformance Requirements 
Reference (CRR) and the different test cases. 

4.4 Initial Conditions 

The Initial Conditions are a set of general prerequisites for the SIM prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

unless otherwise stated, the file system and the files' content shall fulfil the requirements described in annex C; 

unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages specific 
to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 

4.5 Package name 

Java packages integrating this Test Suite shall follow this naming convention: 

siin.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the 
3GPP TS 43.019 [7] sim. access package. 

sim.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the 
3GPP TS 43.019 [7] framework. 

sim.test.util: for the Test util package defined in this Test Suite. 

sim. test.toolkit. [Test Area Reference]: Java Card packages containing Test Area References for the 
3GPP TS 43.019 [7] sim. toolkit package. 

EXAMPLE: The package ../sim.test.access.[Test Area Reference] creates the following directory structure 
../sim/test/access/[Test Area Reference]/API_l _..._[!. .n].*, where API_l_..._[l..n].'*' are the 
different test applets Java source files used in [Test Area Reference] . 
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4.6 AID Coding 



The AID coding for the Test Packages, Applet classes and Applet shall be as specified in TS 101 220 [14]. In addition, 
the following TAR values are defined for use within the present document: 

TAR Coding (3 bytes/ 24 bits): 



bl 


|b2 


b3 


b4 


b5 


|b6 


: :b21 


|b22 


|b23 


|b24 1 







































Specific Test Applet Name 
Test Package Identifier 



Test package Identifier( bits bl-b3): 

000 reserved (as TAR= '00.00.00' is reserved for Card Manager) 

001 API 

010 Framework 

Oil Loader 

111 sim.test.util 

other values are RFU 
Application Provider specific data (1 byte): 

'00' for Package 

'Or for Applet class 

'02' for Applet Instance 
EXAMPLE: The AID of Package sim.test.util is 'AO 00 00 00 09 00 02 FFFF FF FF 89 EO 00 00 00'. 

4.6.1 Specific Test Applet Name for API 

Specific applet test name (bits b4-b24): 

|b4 |b5 |b6 |b7 |b8 |b9 |bl0|bll|bl2|bl3|bl4|bl5|bl6|bl7|bl8|bl 9|b20|b2l|b22|b23|b24| 



I I Applet instance Number 
Applet Class Number 
Method 
Class 
API Test Package 



for API Test Package(3 bits) 

001 sim. access 

010 sim. toolkit 

other are RFU 

Class (5 bits): need to be assigned specification order see Annex A for the full list 

Method (6 bits): need to be assigned specification order see Annex A for the full list 

Applet Class Number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance Number (2 bits) defined in the test procedure it shall start with 01 for applet instance and shall 
be 00 for package and class. 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



17 



ETSI TS 151 013 V4.1.0 (2003-12) 



4.6.2 Specific Test Applet Name for Frameworl< 

Specific applet test name (bits b4-b24): 

[b4"|b5 |b6 |b7 |b8 |b9 Ibl0|bll|bl2|bl3|bl4|bl5|bl6|bl7|bl8|bl9|b20|b2l|b22|b23|b24| 



I I RFU ( set to ) 

Applet instance Number 

Applet Class Number 

Test Area within the chapter 

Chapter 



for Chapter (5 bits) 

00001 Toolkit Installation Parameters 

00010 Minimum Handler Availability 

00011 Handler Integrity 

00100 Applet Triggering 

00101 Proactive Command Sending 

001 10 Framework Security 

00111 Envelope Response Posting 

01000 File System Context 

01001 Exception Handling 

01010 Other parts transferred to framework from API 

other are RFU 

Test Area within the chapter (6 bits): values are defined in Annex F 

Applet Class number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance number (3 bits) defined in the test procedure it shall start with 01 for applet instance and shall be 
00 for package and class. 



4.7 Test Equipment 



These subclauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

4.7.1 APDUtool 

This test tool shall meet the following requirements: 
be able to send command to the card TPDU; 
be able to check none, only a part, or all of the data returned; 
be able to check none, only part, or all of the status returned; 
be able to accept all valid status codes returned; 
be able to support Reader commands; 
be able to generate a log file for each test execution. 

if more data is returned than defined in the test specification, the tool shall continue; 
if less data is returned than defined in the test specification, the tool shall aborts and return an error; 
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if there is an error in data or status returned, the tool shall abort and return an error. 
The log file produced by the test tool shall include the following information: 
all commands issued; 
all data returned; 
all status returned; 
all errors codes; 

expected data and status in case of error; 
comments from the scripts; 
a log message to report success or failure of the test. 



4.7.2 Util package 



Annex D includes Java source code for the sim.test.util package as well as loading , testing and cleaning script 
examples. 



4.7.3 Applet installation parameters 



4.7.3.1 Security parameters 

Loading scripts shall use the following security parameters as stated in 3GPP TS 23.048 [8] for applet installation: 



Parameter 


Value in hexadecimal 


SPI 


OAOO 


KIC 


00 


KID 


11 


TAR 


GO 00 00 


CNTR 


GO 00 00 GO G1 


PCNTR 


00 


Key 


01 23 45 67 89 AB CD EF 



4.7.3.2 



Loading components 



Cap files in loading scripts shall not include the descriptor component as described in Java Card 2.1 VM Architecture 
Specification [13]. 



4.8 Testing methodology 



4.8.1 Test interfaces and facilities 

The SIM -ME interface provides the main transport interface for the purpose of performing conformance tests. 
The SIM API interface provides the main test interface for the purpose of performing conformance tests. 



Test plan 



The test plan is divided according to the SIM API specification, that way the tests will follow the class hierarchy for the 
sim.toolkit and sim.access package; for the SIM Toolkit framework this test plan describes the different points that will 
be tested with the present test specification. 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 19 ETSI TS 151 013 V4.1.0 (2003-12) 

6 API Test Plan 

6.1 Package sim. access: 
6.1.1 Interface SIM View 

NOTE: The Test applet shall be run on a class that implements this interface. 

6.1.1.1 Constants 

Test Area Reference: API_l_SVW_CONST 

6.1 .1 .1 .1 Conformance Requirements 

This subclause does not describe the conformance requirements for a method, but rather for the constants of the 
interface. 

6.1.1.1.1.1 Normal execution 

CRRNl: The constants shall have the same name and value that is defined in 3GPP TS 43.019 [7]. 

6.1.1.1.2 Test Suite Files 
None. 

6.1.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.1 .1 .2 Method select(short fid, byte[] fci, short fciOffset, short fciLength) 

Test Area Reference: API_1_SVW_SLCTS_BSS 

6.1.1.2.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short select (short fid, 
byte [ ] fci, 
short fciOffset, 
short fciLength) 
throws Java . lang . NullPointerException, 

Java. lang. ArraylndexOutOfBoundsException, 
SIMViewException 

6.1.1.2.1.1 Normal execution 

• CRRNl: If the desired file is selected, the length of the FCI (File Control Information) which has been written to 
the array fci is returned. 

• CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI 
structure is copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN4: After selecting a DF/MF no EF is selected. 

• CRRN5: After selecting a linear fixed EF no record is selected. 
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• CRRN6: After selecting a cyclic EF the first record which is the last updated record is selected. 

• CRRN7: The current files (file context) of any other applets shall not be changed. See TS 43.019 [7] - §5.2. This 
will be tested during the testing of the framework. 

• CRRN8: The information returned by fci shall be formatted as described in TS 51.01 1 [3], §9.2.1. 

• CRRN9: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected, 

5) The MF can always be selected. 

6.1.1.2.1.2 Parameter errors 

• CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fciOffset plus fciLength is greater than the length of the array fci.length, or fciOffset equals 
fci. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.2.1.3 Context errors 

• CRRCl: If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CRRN9, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.2.2 Test Suite Files 

Additional requirements for the GSM personalization: None 

Test Script: API_l_SVW_SLCTS_BSS_l.scr 

Test Applet: API_l_SVW_SLCTS_BSS_l.java 

Load Script: API_l_SVW_SLCTS_BSS_l.ldr 

Cleanup Script: API_l_SVW_SLCTS_BSS_l.clr 

Parameter File: API_1_S VW_SLCTS_BSS_1 .par 
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6.1.1.2.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Select EFICCID in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
byte [ ] fci = new byte[34] 
fciOffset = 
fciLength = 20 
select 


No exception shall be thrown. 
Shall return a value not greater 
than 20. 

<Description of fci: 

XX XX 

XX XX 

2FE2 

04 

> 




2 


Select EFicciD in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
fciOffset = 
fciLength = 13 
select {) 


No exception shall be thrown. 
Shall return 13. 

fci shall contain the first 1 3 bytes of 
the FCI structure. 




3 


Select DFgsm in MF 

fid = SIMView.FID_DF_GSM 
fciOffset = 
fciLength = 7 
select 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the first 7 bytes 

of the FCI. 

<Description of fci: 

XX XX 
XX XX 

7F 20 

02 
> 




3 


Select DFgsm in MF 

fid = SIMView.FID_DF_GSM 
fciOffset = 
fciLength = 7 
select 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the entire FCI 

structure. 

<Description of fci: 

XX XX 
XX XX 

IF 20 

02 
> 




4 


Select EFacm in DFgsm (CyclicEF) 

fid = SIMView.FID_EF_ACM 
fciOffset = 
fciLength = 20 
select 


No exception shall be thrown. 
Shall return a value between 15 
and 20. (Cyclic EF) 
fci shall contain the first 1 5 or more 
bytes of the FCI structure. 
fci[14] shall have the value 3 
(length of record). 




5 


Select MF 

fid = SIMView.FID_MF 
fciOffset = 
fciLength = 34 
select {) 


No exception shall be thrown. 

Shall return a value between 22 

and 34. 

fci shall contain the entire FCI 

structure. 




6 


Select DFtelecom in MF 

fid = SIMView.FID„DF_TELECOM 
fci [0] = fci [1] = '05' 
fciOffset = 2 
fciLength = 20 
select 


No exception shall be thrown. 
Shall return 20. 

fci shall contain the first 20 bytes of 
the FCI structure starting at index 
2. The first two bytes shall (still) 
have the value '05'. 




7 


Select EFfdn in DFtelecom (Linear FixedEF) 

fid = SIMView.FID_EF_FDN 
fciOffset = 
fciLength = 15 
select 


No exception shall be thrown. 

Shall return 15. 

fci shall contain the first 1 5 bytes of 

the FCI structure. 

fci[14] shall have the value 28 

(length of record). 




8 


fci is null 

fid = SIMView.FID_EF_FDN 
byte [ ] nullBuffer = null 
fciOffset = 
fciLength = 15 
select {) 


Shall throw 
java.lang.NullPointerException. 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


fciOffset < 

fid = SIMView.FID_EF_FDN 
fciOffset = -1 
fciLength = 15 
select 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




10 


fciLength < 

fid = SIMView.FID_EF_FDN 
fciOffset = 
fciLength = -1 
select 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




11 


fciOffset + fciLength > fci. length 

fid = SIMView.FID_EF_FDN 
fciOffset = 20 
fciLength = 15 
select 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




12 


fciOffset fci.length 

fid = SIMView.FID_EF_FDN 
fciOffset = 34 
fciLength = 1 
select 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception 




13 


Selection possibilities 

1 - fid = SIMView.FID_MF 
fciOffset = 
fciLength = 15 

select 

2 - fid = SIMView.FID_DF_TELECOM 
select 

3 - fid = SIMView.FID_DF_GRAPHICS 
select 

4 - fid = SIMView.FID_DF_TELECOM 
select 

5 - fid = SIMView.FID_DF_GRAPHICS 
select {) 

6 - fid = SIMView.FID_MF 
select 

7 - fid = SIMView.FID_DF_GSM 
select 

8 - fid = SIMView.FID_DF_TELECOM 
select 

9 - fid = SIMView.FID_DF_TELECOM 
select 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 

6 - No exception shall be thrown. 

7 - No exception shall be thrown. 

8 - No exception shall be thrown. 

9 - No exception shall be thrown. 




14 


EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select 

fid = SIMView.FID_EF_ICCID 
select 

2 - fid = SIMView.FID_MF 
select 

readBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




15 


No selection of non-reachable file 

1 - fid = SIMView.FID_MF 
select {) 

2 - fid = SIMView.FID_EF_ACM 
select 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code FILE_NOT_FOUND. 




16 


No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 
select 

2 - fid = FID_DF_SIMTEST 
select 

3 - fid = FID_EF_LARU 
select 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Record pointer in selected cyclic EF 


1 - No exception shall be thrown. 






1 - fid = SIMView.FID_MF 


2 - No exception shall be thrown. 






select 


3 - No exception shall be thrown. 






2 - fid = FID_DF_SIMTEST 
select 

3 - fid = FID_EF_CARU 
select 


4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 






4 - byte[] datal = { 1,2,3 } 








mode = REC_ACC_MODE_PREVIOUS 








updateRecord (datal ) 








5 - fid = FID EF CARU 








select 








readRecord {data2 ) 








compare datal to data2 







6.1.1.2.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-7 


N2 


3,5 


N3 


1,2,4,6,7 


N4 


14 


N5 


16 


N6 


17 


N8 


1,3 


N9 


1-7, 13 


PI 


8 


P2 


9 


P3 


10 


P4 


11, 12 


CI 


15 


C2, C3 


Not Tested 



6.1.1.3 Method select (short fid) 

Test Area Reference: API_1_SVW_SLCTS 

6.1.1.3.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void select (short fid) 

throws SIMViewException 

6.1.1.3.1.1 Normal execution 

• CRRNl: If the desired file is selected, no exception is thrown. 

• CRRN2: After selecting a DF/MF no EF is selected. 

• CRRN3: After selecting a linear fixed EF no record is selected. 

• CRRN4: After selecting a cyclic EF the first record which is the last updated record is selected. 

• CRRN5: The current files (file context) of any other applets shall not be changed [TS 43.019 [7] - §5.2]. This 
will be tested during the testing of the framework. 

• CRRN6: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 
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4) The parent MF/DF of the current DF can be selected, 

5) The MF can always be selected. 



6.1.1.3.1.2 

No requirements. 

6.1.1.3.1.3 



Parameter errors 



Context errors 



• CRRCl : If the file with a File-ID which matches fid could not be found according to the selection rules listed in 
CCRN6, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.3.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.3.3 



API_1_S VW_SLCTS_1 .scr 
API_l_SVW_SLCTS_l.java 
API_1_S VW_SLCTS_1 .Idr 
API_1_S VW_SLCTS_1 .clr 
API_1_S VW_SLCTS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Select EFicciD in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
select 


No exception shall be thrown. 




2 


EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select 

fid = SIMView.FID_EF_ICCID 
select 

2 - fid = SIMView.FID_MF 
select {) 

readBinary {) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




3 


No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 
select 

2 - fid = FID_DF_SIMTEST 
select 

3 - fid =FID_EF_LARU 
select 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord {) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select 

2 - fid =FID_DF_SIMTEST 
select 

3 - fid = FID_EF_CARU 
select 

4 - byte[] datal = { 1,2,3 } 
updateRecord (datal ) 

5 - fid = FID_EF_CARU 
select 

readRecord (data2 ) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 




5 


Selection possibilities 

1 - fid = SIMView.FID_MF 
select 

2 - fid = SIMView.FID_DF_TELECOM 
select 

3 - fid = SIMView.FID_DF_GRAPHICS 
select 

4 - fid = SIMView.FID_DF_TELECOM 
select 

5 - fid = SIMView.FID_DF_GRAPHICS 
select 

6 - fid = SIMView.FID_MF 
select 

7 - fid = SIMView.FID_DF_GSM 
select 

8 - fid = SIMView.FID_DF_TELECOM 
select 

9 - fid = SIMView.FID_DF_TELECOM 
select 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 

6 - No exception shall be thrown. 

7 - No exception shall be thrown. 

8 - No exception shall be thrown. 

9 - No exception shall be thrown. 




6 


No selection of unreachable file 

1 - fid = SIMView.FID_MF 
select 

2 - fid = SIMView.FID_EF_ACM 
select 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code FILE_NOT_FOUND. 





6.1.1.3.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1 


N2 


2 


N3 


3 


N4 


4 


N6 


5 


CI 


6 


C2, C3 


Not Tested 



6.1.1.4 Method status 

Test Area Reference: API 1 SVW STAT BSS 



6.1.1.4.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short status (byte [ ] fci, 

short fciOffset, 
short fciLength) 
throws Java. lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
SIMViewException 



6.1.1.4.1.1 



Normal execution 



CRRNl: The FCI (File Control Information) of the current DF (or MF) is returned in the same format as for a 
SELECT command in case of selecting an MF/DF (described in 3GPP TS 43.019 [7], subclause 9.2.1). 
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• CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI 
structure is copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

6.1.1.4.1.2 Parameter errors 

• CRRPl: If the array fci is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals 
fci. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 



6.1.1.4.1.3 



Context errors 



• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.4.2 Test Suite Files 

Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.4.3 



API_l_SVW_STAT_BSS_Lscr 
API_l_SVW_STAT_BSS_l.java 
API_1_S VW_STAT_BSS_1 .Idr 
API_1_S VW_STAT_BSS_1 .clr 
API_1_S VW_STAT_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Status of MF 

byte [ ] fci = new byte[34] 
fciOffset = 
fciLength = 7 
status 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the entire FCI 

structure. 

<Description of fci: 

XX XX 

XX XX 

3F00 

01 

> 




2 


Status after select EFiccid in MF 

1 - fici = SIMView.FID_DF_GSM 
fciOffset = 

fciLength = 34 
len = select ( ) 

2 - byte [ ] fci2 = new byte [34] 

len2 = status ( ) 

3 - Compare len and len2 

4 - Compare the len bytes of fci and fci2 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return 22 or more. 

3 - len and Ien2 shall be identical 

4 - fci and fci2 shall be identical 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



27 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


3 


Status of DFielecom 

1 - fid = SIMVlew.FID_DF_TELECOM 
select 

2 - fciOffset = 
fclLength = 100 
status {) 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return a value between 22 
and34. 

fci shall contain the entire FCI 
structure (check that returned value 
is equal to 13 plus the "length of 
following data" - fci[12]).FID of the 
returned fci (fci[4:5]) is 
FID_DF_TELECOM. 




4 


Status DFtelecom 

fciOffset = 
fclLength = 7 
status 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the first 7 bytes of 

the FCI structure starting at index 

0. 

FID of the returned fci (fci[4:5]) is 

FID DF TELECOM. 




5 


fci is null 

byte [ ] nullBuffer = null 
fciOffset = 
fclLength = 34 
status 


Shall throw 
java.lang.NullPointerException. 




6 


fciOffset < 

fciOffset = -1 
fclLength = 34 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




7 


fclLength < 

fciOffset = 
fclLength = -1 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


fciOffset + fclLength > fci.length 

fciOffset = 20 
fclLength = 15 
status 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




9 


fciOffset fci.length 

fciOffset = 34 
fclLength = 1 
status {) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 





6.1.1.4.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-4 


N2 


2,3 


N3 


1,4 


PI 


5 


P2 


6 


P3 


7 


P4 


8,9 


C1,C2 


Not Tested 



6.1 .1 .5 Method readBinary 

Test Area Reference: API 1 SVW REDBS BSS 
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6.1.1.5.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short readBinary (short fileOffset, 

byte [ 1 resp, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 

6.1.1.5.1.1 Normal execution 

• CRRNl: If data can be accessed at the specified offset, the value respOffset plus respLength are returned and the 
data bytes of the currently selected transparent file are returned in resp. 

6.1.1.5.1.2 Parameter errors 

• CRRPl : If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

• CRRP2: If fileOffset plus respLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIM ViewException.OUT_OF_FILE_BOUND ARIES. 

• CRRP3: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP4: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP6: If respOffset plus respLength is greater than the length of the array resp.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.5.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for the reading of 
an invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.5.2 Test Suite Files 

Additional requirements for the GSM personalization: none. 
Test Script: API_l_SVW_REDBS_BSS_l.scr 

Test Applet: API_l_SVW_REDBS_BSS_Ljava 

Load Script: API_l_SVW_REDBS_BSS_l.ldr 
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Cleanup Script: 
Parameter File: 

6.1.1.5.3 



API_1_S VW_REDBS_BSS_1 .clr 
API_1_S VW_REDBS_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored 




1 


Read from EFICCID in MF (Transparent EF) 

1 - fid = SIMView.FID_EF_ICCID 
select {) 

2 - fileOffset = 

byte [ ] resp = new byte [20] 
resp[0:19] = '55' 
respOffset = 10 
respLength = 10 
readBinary () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 20. 

resp shall contain the entire 

contents of EFICCID starting at 

index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

OF FF FF FF FF FF FF FF FF FF 

> 




2 


Read from EFICCID in MF 

resp[0:19] = '55' 
fileOffset = 5 
respOffset = 10 
respLength = 5 
readBinary () 


No exception shall be thrown. 

Shall return 15. 

resp shall contain the last 5 bytes 

of EFICCID starting at index 10. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF 55 55 55 55 55 

> 




3 


Offset into File out of bounds 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




4 


fileOffset + respLength > EF length 

fileOffset = 9 
respOffset = 
respLength = 2 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


resp is null 

byte[] nullBuffer = null 
fileOffset = 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 
java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


respOffset + respLength > resp.length 

fileOffset = 
respOffset = 10 
respLength = 11 
readBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select 

2 - fid = FID_EF_LARU 
select 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Access condition not fulfilled 


Shall throw 






1 - fid = DFSIMTTEST 
select 

2 - fid = EFTNR 
select 


sim. access. SIMVIewException with 
reason code 
AC_NOT_FULFILLED. 






3 - fileOffset = 








respOffset = 








respLength = 1 








readBinary () 






11 


EF Is Invalidated 


1 - No exception shall be thrown. 






1 - fid = EFTNU 


2 - Shall throw 






invalidate () 

2 - readBinary 

3 - rehabilitate 


sim. access. SIMVIewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 




12 


No EF selected 

1- fid = SIMView.FID_MF 


1 - No exception shall be thrown. 

2 - Shall throw 






select 

2 readBinary 


sim. access. SIMVIewException with 
reason code NO EF SELECTED. 





6.1.1.5.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


1-2 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8, 


CI 


12 


C2 


9 


C3 


10 


C4 


11 


C5, C6 


Not Tested 



6.1 .1 .6 Method updateBinary 

Test Area Reference: API_1_SVW_UPDBS_BSS 

6.1.1.6.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateBinary (short fileOffset, 

byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
SIMVIewException 



6.1.1.6.1.1 



Normal execution 



• CRRNl: The currently selected transparent file is updated starting at fileOffset, with the string of dataLength 
bytes in the array data starting at dataOffset. 



6.1.1.6.1.2 



Parameter errors 



CRRPl : If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 
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CRRP2: If fileOffset plus dataLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUND ARIES. 

CRRP3: If the array data is null, an instance of NullPointerException shall be thrown. 

CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 



6.1.1.6.1.3 



Context errors 



• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating of an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.6.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.6.3 



API_1_S VW_UPDBS_BSS_1 .scr 
API_l_SVW_UPDBS_BSS_l.java 
API_1_S VW_UPDBS_BSS_1 .Idr 
API_1_S VW_UPDBS_BSS_1 .clr 
API_1_S VW_UPDBS_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw 

Sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



32 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


2 


Update Transparent EF 

1 - fid = DFSIMTEST 
select 

2 - fid = EFTARU 
select 

3 - fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

4 - fileOffset = 3 
respOffset = 
respLength = 1 
readBinary () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


1 - fileOffset = 254 

data[0] = '55' 
data[l] = 'AA' 
data[2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary () 
2 - fileOffset = 254 
respOffset = 
respLength = 3 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1 ] = 'AA' 
resp[2] = '66' 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary () 


Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte[] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength = 10 
updateBinary () 


Shall throw 
java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 

dataOffset = -1 
dataLength = 10 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select 

2 - fid = FID_EF_LARU 
select {) 

3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Access condition not fulfilled 

1 - fid = DFSIMTEST 
select 

fid = EFTNU 
select 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




12 


EF is invalidated 

1 - fid = EFTNR 
invalidate () 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary () 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 





6.1.1.6.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3 


P1 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, C6 


Not Tested 



6.1 .1 .7 Method read Record 

Test Area Reference: API 1 SVW REDRSBS BSS 



6.1.1.7.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short readRecord (short recNumber^ 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 



6.1.1.7.1.1 



Normal execution 



• CRRNl: The data bytes from the record, specified by mode and recNumber of the currently selected linear fixed 
or cyclic EF, is read at recOffset. A total of respLength bytes of this data is copied to the array resp at respOffset. 

• CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT: 

if recNumber is not 0, the record addressed by recNumber will be read; 
if recNumber is the current selected record will be read; and 
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the current record pointer shall not change. 

• CRRN3: If the access mode is REC_ACC_MODE_NEXT: 

the next record relative to the current selected record will be selected and read; 

if no current record is selected, the first record will be selected and read; 

if the current record pointer is set to the last record for a cyclic EF the record pointer is set to the first record 
and the record is read; 

the current record pointer of any other applet shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and read; 

if no current record is selected, the last record will be selected and read; 

if the current record pointer is set to the first record, for a linear fixed EF the method responses with an error 
exception and for a cyclic EF the record pointer is set to the last record and the record is read; 

the current record pointer of any other applet shall not be changed. 

6.1.1.7.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP2; If the currently selected EF is linear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP3: If the currently selected EF is Unear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and 
the current record pointer is set to the first record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of SIMViewException shall 
be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp.length, or respOffset equals 
resp. length, an instance of ArraylndexOutOfBoundsException shall be thrown. 
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6.1.1.7.1.3 



Context errors 



• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILE_INCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.7.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.7.3 



API_1_S VW_REDRSBS_BSS_1 .scr 
API_l_SVW_REDRSBS_BSS_l.java 
API_1_S VW_REDRSBS_BSS_1 .Idr 
API_l_SVW_REDRSBS_BSS_l.clr 
API_1_S VW_REDRSBS_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte [ ] resp = new byte [20] 

respOffset = 

respLength = 10 

readRecord 


Shall throw 

sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute and Current from Linear Fixed 
EF 

1 - fid = DFSIMTEST 
select {) 

2 - fid = EFLARU 
select {) 

// Record pointer not set. 

3 - recNumber = 

mode = REC_ACC_MODE„NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

4 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 

5 - recNumber = 1 
readRecord () 

6 - recNumber = 

resp[0] = resp[l] = resp[2] = resp[3] = 

'00' 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 
resp[3] = 'AA' 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

6 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 




3 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = 'AA' 

resp[1] = 'AA' 

resp[2] = 'AA' 

resp[3] = 'AA' 




4 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 


Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




5 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = '55' 

resp[1] = '55' 

resp[2] = '55' 

resp[3] = '55' 




6 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 4 

readRecord () 


Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Read Absolute and Current from Cyclic EF 

1 - fid = EFCARU 
select 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE„CURRENT 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 

3 - recNumber = 1 
readRecord ( ) 

4 - recNumber = 

resp[0] = resp[l] = resp[2] = '00 
readRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = ' AA' 
resp[1 ] = ' AA' 
resp[2] = ' AA' 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




8 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC„MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord () 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




9 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




10 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




11 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 

respOffset = 

respLength = 3 

readRecord 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




12 


Read Absolute from Linear Fixed EF beyond 

Records 

1 - fid = EFLARU 
select 

2 - recNumber = -1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

3 - recNumber = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 




13 


No current record in linear fixed EF, read 

current 

1 - fid = EFLARU 

select // No curr rec 

2 - recNumber = // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

RECORD NUMBER NOT AVAIL 

ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset < 

1 - fid = EFLARU 
select 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE„CURRENT 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord () 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




15 


recOffset + respLength > Record Length 

1 - fid = EFLARU 
select 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord () 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




16 


Reading with invalid mode 

1 - fid = EFLARU 
select {) 

2 - recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord () 

3 - mode = 5 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




17 


resp is null 

byte[] nullBuffer = null 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 

respLength = 10 

readRecord ( ) 


Shall throw 
java.lang.NullPointerException. 




18 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


respLength < 

respOffset = 
respLength = -1 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
select 

2 - fid = EFTNU 
select 

3 - respOffset = 
respLength = 4 
readRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNR 
select {) 

2 - respLength = 3 
readRecord {) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNU 
invalidate () 

2 - readRecord 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 
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6.1.1.7.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2-5,7-11 


N2 


2,7 


N3 


3,8,9 


N4 


5, 10, 11 


PI 


12 


P2 


13 


P3 


4 


P4 


6 


P5 


14 


P6 


15 


P7 


16 


P8 


17 


P9 


18 


P10 


19 


P11 


20 


CI 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1 .1 .8 Method updateRecord 

Test Area Reference: API_1_SVW_UPDRSBS_BSS 

6.1.1.8.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void updateRecord (short recNumber, 

byte mode, 
short recOffset, 
byte [ ] data, 
short dataOffset, 
short dataLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 



6.1.1.8.1.1 



Normal execution 



CRRNl: dataLength bytes of the record specified by mode and recNumber of the current selected linear fixed or 
cyclic EF are updated at recOffset, by using the string of bytes in the array data starting at dataOffset. 

CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT and the file is a linear fixed EF: 

the record addressed by recNumber will be updated; 

if recNumber is the current selected record will be updated; and 

the current record pointer shall not change. 
CRRN3: If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF: 

the next record relative to the current selected record will be selected and updated; 

if no current record is selected, the first record will be selected and updated; 

the current record pointer of any other applet shall not be changed. 
CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

the previous record relative to the current selected record will be selected and updated; 
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if no current record is selected, the last record will be selected and updated; 

if a cyclic EF is updated, the oldest record will be updated independent of the current record pointer and this 
record becomes record number 1 and the current record; 

the current record pointer of any other applet shall not be changed in case of a linear fixed EF. 

6.1.1.8.1.2 Parameter errors 

• CRRPl : If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 



• 



• 



CRRP2: If the currently selected EF is linear fixed and the access mode is 

REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and 
the current record pointer is set to the first record; an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record length, an instance of SIMViewException shall 
be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

• CRRP9: If the array data is null, an instance of NullPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.8.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither linear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 



6.1.1.8.2 



Test Suite Files 



Additional requirements for the GSM personalization: This test is based on the assumption that the contents of the EFs 
in DFsiMTEST are identical to those defined in the default pre-personalization and the current record pointers have not 
been altered. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.8.3 



API_1_S VW_UPDRSBS_BSS_1 .scr 
API_l_SVW_UPDRSBS_BSS_l.java 
API_1_S VW_UPDRSBS_BSS_1 .Idr 
API_1_S VW_UPDRSBS_BSS_1 .clr 
API_1_S VW_UPDRSBS_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte[] data = new byte [20] 

dataOffset = 

dataLength = 10 

updateRecord () 


Shall throw 

Sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 




2 


Update Absolute and Current from Linear 
Fixed EF 

1 - fid = DFSIMTEST 
select 

2 - fid = EFLARU 
select 

// Record pointer not set. 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLDTE_CDRRENT 

data[0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord () 

respOffset = 

respLength = 

readRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '11' 
Resp[1] = '11' 
Resp[2] = '11' 
Resp[3] = '11' 


= 4 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Update Current from Linear Fixed EF 


1 - No exception shall be thrown. 






1 - fid = DFSIMTEST 


2 - No exception shall be thrown. 






select 


3 - No exception shall be thrown. 






2 - fid = EFLARU 

select 

// Set record pointer with mode "next". 


4 - No exception shall be thrown, 
resp shall be: 






3 - recNumber = 


resp[0] = '22' 






mode = REC_ACC_MODE_NEXT 


resp[1] = '22' 






recOffset = 


resp[2] = '22' 






data[0:3] = '00' 


resp[3] = '22' 






dataOffset = 








dataLength = 4 








updateRecord () 








// write data with mode "current" 








4 - recNumber = 








data[0:3] = '22' 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








updateRecord ( ) 








// read result with mode "absolute" 








respOffset = 








respLength = 4 








recNumber = 1 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








readRecord () 






4 


Update Next from Linear Fixed EF, no record 


1 - No exception shall be thrown. 






pointer set 


2- No exception shall be thrown. 






1 - fid = FID_DF_SIMTEST 


3 - No exception shall be thrown. 






select {) 


Resp shall be: 






2 - fid = FID_EF_LARU 


Resp[0] = '33' 






select 

3 - recNumber = 


Resp[1] = '33' 






mode = REC_ACC_MODE_NEXT 


Resp[2] = '33' 






recOffset = 


Resp[3] = '33' 






data[0:3] = '33' 








dataOffset = respOffset = 








dataLength = respLength = 4 








updateRecord ( ) 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








readRecord ( ) 






5 


Update Next from Linear Fixed EF, record 


1 - No exception shall be thrown. 






pointer set 


2 - No exception shall be thrown. 






1 - recNumber = 


resp shall be: 






mode = REC_ACC_MODE_NEXT 


resp[0] = '44' 






recOffset = 
data[0:3] = '44' 
dataOffset = 


resp[1] = '44' 
resp[2] = '44' 






dataLength = 4 


resp[3] = '44' 






updateRecord ( ) 








2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








readRecord ( ) 






6 


Update Next from Linear Fixed EF, no more 


Shall throw 






records 


Sim. access. SIMViewException with 






recNumber = 


reason code 






mode = REC_ACC_MODE„NEXT 


RECORD NUMBER NOT AVAIL 






recOffset = 


ABLE. 






data[0:3] = '55' 








dataOffset = 








dataLength = 4 








updateRecord () 






7 


Update Previous from Linear Fixed EF, no 


1 - No exception shall be thrown. 






record pointer set 


2 - No exception shall be thrown. 






1 - fid = DFSIMTEST 


3 - No exception shall be thrown. 






select {) 


4 - No exception shall be thrown. 






2 - fid = EFLARU 


resp shall be: 






select {) 

3 - recNumber = 


resp[0] = '66' 






mode = REC_ACC_MODE_PREVIOUS 


resp[1] = '66' 






recOffset = 


resp[2] = '66' 






data[0:3] = '66' 


resp[3] = '66' 






dataOffset = respOffset = 








dataLength = respLength = 4 








updateRecord ( ) 








4 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








readRecord ( ) 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Update Previous from Linear Fixed EF, record 


1 - No exception shall be thrown 






pointer set 


2 - No exception shall be thrown. 






1 - recNumber = 


Resp shall be: 






mode = REC_ACC_MODE_PREVIOUS 


Resp[0] = 7744' 






recOffset = 
data[0:3] = '77' 
dataOffset = respOffset = 


Resp[1] = '7744' 
Resp[2] = 7744' 






dataLength = respLength = 4 


Resp[3] = '7744' 






updateRecord () 








readRecord () 








2 - mode = REC„ACC_MODE_ABSOLUTE_CURRENT 






9 


Update Previous from Linear Fixed EF , no 


Shall throw 






more records 


sim. access. SIMViewException with 






recNumber = 


reason code 






mode = REC_ACC_MODE_PREVIOUS 


RECORD NUMBER NOT AVAIL 






recOffset = 


ABLE. 






data[0:3] = '88' 








dataOffset = respOffset = 








dataLength = respLength = 4 








updateRecord ( ) 






10 


Update Previous from Cyclic EF 


1 - No exception shall be thrown. 






1 - fid = FID_DF_SIMTEST 


2 - No exception shall be thrown. 






select {) 


3 - No exception shall be thrown. 






2 - fid = FID_EF_CARU 
select 

3 - recNumber = 2 


4 - No exception shall be thrown. 

5 - No exception shall be thrown. 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


resp shall be: 






recOffset = 


resp[0] = data[0] 






respOffset = 


resp[1] = data[1] 






respLength = 3 


resp[2] = data[2] 






readRecord ( ) 








4 - recNumber = 2 








mode = REC_ACC_MODE_PREVIOUS 








data [0:2] = resp[0:2] " 'FF' 








dataOffset = 








dataLength = 3 








updateRecord () 








5 - recNumber = 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








respOffset = 








respLength = 3 








readRecord () 






11 


Update Absolute from Linear Fixed EF beyond 


1 - No exception shall be thrown. 






Records 


2 - Shall throw 






1 - fid = EFLARU 


sim. access. SIMViewException with 






select {) 


reason code 






2 -recNumber = -1 


RECORD_NUMBER_NOT_AVAIL 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 










ABLE. 






recOffset = 








dataOffset = 


3 - Shall throw 






dataLength = 4 


sim. access. SIMViewException with 






updateRecord ( ) 


reason code 






2 - recNumber = 3 


RECORD NUMBER NOT AVAIL 






updateRecord ( ) 


ABLE. 




12 


No current record in linear fixed EF, update 


1 - No exception shall be thrown. 






current 


2 - Shall throw 






1 - fid = EFLARU 


sim. access. SIMViewException with 






select // No curr rec 


reason code 






2 - recNumber =0 // curr rec 


RECORD NUMBER NOT AVAIL 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


ABLE. 






recOffset = 








dataOffset = 








dataLength = 4 








updateRecord () 






13 


recOffset < 


1 - No exception shall be thrown. 






1 - fid = EFLARU 


2 - Shall throw 






select 


sim. access. SIMViewException with 






2 - recNumber =1 // rec 1 


reason code 






mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


OUT_OF_RECORD_BOUNDARIE 






recOffset = -1 








dataOffset = 


S. 






dataLength = 4 








updateRecord ( ) 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset + dataLength > Record Length 

1 - fid = EFLARU 
select 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S. 




15 


Updating with invalid mode 

1 - fid = EFLARU 
select 

2 - recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord () 

3 - mode = 5 
updateRecord () 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code INVALID MODE. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




16 


Updating Cyclic EF with invalid mode 

1 - fid = DFSIMTEST 
select 

2 - fid = EFCARU 
select 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord () 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord () 

5 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID MODE. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 

5 - Shall throw 

sim. access. SIMViewException with 
reason code INVALID_MODE. 




17 


data is null 

byte[] nullBuffer = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 
java.lang.NullPointerException. 




18 


dataOffset < 

dataOffset = -1 
dataLength = 10 
updateRecord {) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




19 


dataLength < 

dataOffset = 
dataLength = -1 
updateRecord () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
select 

2 - fid = EFTNR 
select 

3 - dataOffset = 
dataLength = 4 
updateRecord () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNGONSISTENT. 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Access condition not fulfilled 

1 - fid = EFCNU 
select {) 

2 - recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord ( ) 

3 - fid = EFLNU 
select 

4 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 

3 - No exception shall be thrown. 

4 - Shall throw 

Sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNR 
invalidate () 

2 - updateRecord 

3 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

Sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

3 - No exception shall be thrown. 





6.1.1.8.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3,4,5,7,8,10 


N2 


2,3 


N3 


5,6 


N4 


7,8,9, 10 


PI 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


CI 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.9 Method seek 

Test Area Reference: API 1 SVW SEEKB BSS 



6.1.1.9.1 



Conformance Requirements 



The method with the following header shall be compliant to its definition in the API. 

public short seek (byte mode, 

byte [ ] patt, 
short pattOffset, 
short pattLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 
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6.1.1.9.1.1 Normal execution 

• CRRN 1 : If the pattern in patt with the length pattLength at offset pattOffset is found in the record being 
specified by mode, the current record pointer is set to that record and the record number is returned. The record 
pointer of any other applet is not changed. This will be tested during the testing of the framework. 

• CRRN2: If mode is SEEK_FROM_BEGINNING_FORWARD, the search starts with the first record forward 
towards the end of the file. 

• CRRN3: If mode is SEEK_FROM_END_BACKWARD, the search starts with the last record backward towards 
the beginning of the file. 

• CRRN4: If mode is SEEK_FROM_NEXT_FORWARD, the search starts from the next record after the current 
record pointer forward towards the end of file. If no current record pointer is selected, the search starts with the 
first record. 

• CRRN5: If mode is SEEK_FROM_PREVIOUS_BACKWARD, the search starts from the previous record 
before the current record pointer backward towards the beginning of the file. If no current record pointer is 
selected the search starts with the last record. 

• CRRN6: If pattern in patt is not found, an instance of SIMViewException shall be thrown. The reason code shall 
beSIMViewException.PATTERN_NOT_FOUND. 

• CRRN7: If mode is SEEK_FROM_NEXT_FORWARD and the record pointer is at the last record, an instance 
of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

• CRRN8: If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

6.1.1.9.1.2 Parameter errors 

• CRRPl : If mode is not between and 3 inclusive (0 = SEEK_FROM_BEGINNING_FORWARD, etc.), an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If pattOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If pattLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If pattLength is greater than the size of the record of the currently selected EF, an instance of 
SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_RECORD_BOUNDARIES. 

• CRRP6: If pattOffset plus pattLength is greater than the length of the pattern array patt. length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.9.1.3 Context errors 

• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not linear fixed, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException. AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



47 



ETSI TS 151 013 V4.1.0 (2003-12) 



• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.9.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.9.3 



API_l_SVW_SEEKB_BSS_l.scr 

API_l_SVW_SEEKB_BSS_l.java 

API_l_SVW_SEEKB_BSS_l.ldr 

API_l_SVW_SEEKB_BSS_l.ldr 

API_l_SVW_SEEKB_BSS_l.par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

Byte[] patt = new byte [20] 

pattOffset = 

pattLength = 10 

mode = SEEK_FROMJEGINNING_FORWARD 

seekO 


Shall throw 

Sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 




2 


Pattern not Found 

1 - fid = DFSIMTEST 
select 

2 - fid = EFLARU 
select 

3 - patt [0] = 'DA' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

PA 1 1 bRN_NOT_FOUND. 




3 


Seek from Beginning Forward 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


No exception shall be thrown. Shall 
return 1 




4 


Seek from End Backward 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_END_BACKWARD 

seek 


No exception shall be thrown. Shall 
return 1 




5 


Seek from Next Forward 

patt [0:2] = 'AA' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seek {) 


No exception shall be thrown. Shall 
return 2 




6 


Last Record, Seek from Next Forward 

mode = SEEK_FROM__NEXT_FORWARD 
seekO 


Shall throw 

sim. access. SIMViewException with 

reason code 

PAI IbRN NOT FOUND. 




7 


Seek from Previous Backward 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM„PREVIOUS„BACKWARD 

seekO 


No exception shall be thrown. Shall 
return 1 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


First Record, Seek from Previous Backward 

SEEK_FROM_PREVIOUS_BACKWARD 
seekO 


Shall throw 

sim. access. SIMVIewException with 

reason code 

PAI IbRN NOT FOUND. 




9 


Pattern not Found (out of reach) 

patt[0:2] = '55' 

pattOffset = 

pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seek 


Shall throw 

sim. access. SIMVIewException with 

reason code 

PAI lbRN_NOT_FOUND. 




10 


Invalid mode 

1 - mode = 4 
seekO 

2 - mode = -1 
seekO 


1 - Shall throw 

sim. access. SIMVIewException with 
reason code INVALID MODE 

2 - Shall throw 

sim. access. SIMVIewException with 
reason code INVALID MODE 




11 


patt is null 

byte[] nullBuffer = null 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


Shall throw 
java.lang.NullPointerException. 




12 


pattOffset < 

patt[0:2] = '55' 

pattOffset = -1 

pattLength = 3 

mode = SEEK_.FROM_BEGINNING_FORWARD 

seek 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException 




13 


pattLength < 

patt[0:2] = '55' 

pattOffset = 

pattLength = -1 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException 




14 


pattLength > size of record 

patt[0:4] = '55' 

pattOffset = 

pattLength = 4 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


Shall throw 

sim. access. SIMVIewException with 

reason code 

OUT OF RECORD BOUNDARIE 

S 




15 


pattOffset + pattLength > patt.length 

patt[0:2] = '55' 

pattOffset = 1 

pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException 




16 


EF is not Linear Fixed 

1 - fid = EFTNU 
select 

2 - pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seekO 

3 - fid = EFCNU 
select 
seekO 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMVIewException with 

reason code 

FILE INCONSISTENT 

3 - Shall throw 

sim. access. SIMVIewException with 

reason code 

FILE INCONSISTENT 




17 


Access condition not fulfilled 

1 - fid = EFLNR 
select 

2 - patt [0] = '55' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seekO 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




18 


EF is invalidated 

1 - fid = EFLARU 
select 

2 - invalidate 

3 - patt [0] = '55 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seekO 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

4 - No exception shall be thrown. 
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6.1.1.9.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3-6,7 


N2 


3 


N3 


4 


N4 


5 


N5 


7 


N6 


2,6,8,9 


N7 


6 


N8 


8 


PI 


10 


P2 


11 


P3 


12 


P4 


13 


P5 


14 


P6 


15 


CI 


1 


C2 


16 


C3 


17 


C4 


18 


C5, C6 


Not Tested 



6.1.1.10 Method increase 

Test Area Reference: API_1_SVW_INCR_BS_BS 

6.1.1.10.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
byte [ ] resp, 
short respOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
SIMViewException 



6.1.1.10.1.1 



Normal execution 



• CRRN 1 : The value in the array incr is added to the value of the last increased / updated record in the currently 
selected cyclic EF. The result is stored in the oldest record and returned in the array resp. The updated record 
becomes record number 1 and is selected as current record. The number of bytes of valid data in resp is returned. 

6.1.1.10.1.2 Parameter errors 

• CRRP 1 : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If incrOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If incrOffset plus the value 3, is greater than the length of the array incr.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If the result of the addition is greater than the maximum value of the record (represented by all bytes set 
to 'FF'), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.MAX_VALUE_REACHED. 

• CRRP5: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP6: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP7: If the remaining length of the array resp at the offset respOffset is less than the length of the record, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 
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6.1.1.10.1.3 



Context errors 



• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not cyclic, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.FILE_INCONSISTENT. 

• CRRC3: If increase is not allowed as indicated by the FCI byte 8 (TS 5 1 .011 : FCI structure of an EF returned by 
the SELECT command), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_INCONSISTENT. 

• CRRC4: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

• CRRC5: If the currently selected EF is invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC6: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC7: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.10.2 Test Suite Files 

Additional requirements for the GSM personalization: None 

Test Script: API_l_SVW_INCR_BS_BS_l.scr 

Test Applet: API_l_SVW_INCR_BS_BS_l.java 

Load Script: API_l_SVW_INCR_BS_BS_l.ldr 

Cleanup Script: API_l_SVW_INCR_BS_BS_l.clr 

Parameter File: API_1_S VW_INCR_BS_BS_1 .par 



6.1.1.10.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

byte [ ] incr = new byte [4] 
byte [ ] resp = new byte [4] 
incrOffset = 
respOffset = 
increase () 


Shall throw 

sim. access. SIMViewException with 

reason code NO_EF_SELECTED. 




2 


Increase , verify response 

1 - fid = DFSIMTEST 
select {) 

2 - fid = EFCARU 
select 

3 - //Set both records to 00 00 00 
mode = REC_ACC_MODE_PREVIOUS 
data[0:3] = 

dataOffset = 
dataLength = 3 
updateRecord ( ) 
updateRecord () 

4 - incrOffset = 
incr[2] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
resp[] shall contain {0,0,1 ,0}. 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Increase, verify file 

1 - incrOffset = 1 
incr[2] = 0, incr[3] = 2 
respOffset = 1 
increase () 

2 - resp[3] = 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 
readRecord {) 


1 - No exception shall be thrown. 
resp[] shall contain {0,0,0,3}. 

2 - No exception shall be thrown. 
resp[] shall contain {0,0,3,0}. 




4 


incr is null 

byte [ ] nullBuffer = null 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 
java.lang.NullPointerException. 




5 


incrOffset < 

incrOffset = -1 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




6 


incrOffset + 3 > incr.length 

incrOffset = 2 
respOffset = 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




7 


Reach Maximum Value 

incr[0] = incr[l] = incr[2] = ' FF ' 
incrOffset = 
respOffset = 
increase () 


Shall throw 

sim. access. SIMViewException with 

reason code 

MAX_VALUE_REACHED. 




8 


resp is null 

incr[0] = incr[l] = 0x00' 
incr[2] = '02' 
incrOffset = 
byte [ ] respNull = null 
respOffset = 
increase () 


Shall throw 
java.lang.NullPointerException. 




9 


respOffset < 

incrOffset = 
respOffset = -1 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




10 


respOffset + recordLength > resp.length 

incrOffset = 
respOffset = 2 
increase () 


Shall throw 

java.lang. 

ArraylndexOutOfBoundsException. 




11 


EF is not Cyclic 

1 - fid = EFTARU 
select 

2 - incrOffset = 
respOffset = 
increase () 

3 - fid = EFLARU 
select 

4 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 

reason code 

FILE INCONSISTENT. 




12 


Access condition not fulfilled 

1 - fid = EFCNIC 
select 

2 - incrOffset = 
respOffset = 
increase () 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




13 


EF is invalidated 

1 - fid = EFCARU 
select {) 

2 - invalidate 

3 - incrOffset = 
respOffset = 
increase () 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 

4 - No exception shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Check increase not allowed from FCI 

1 - fciOffset = 
fciLength = 8 

select (FID_EF_CINA, f ci . . . ) 
Verify FCI byte 8 (fci[7]) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 
Bit 7 of resp[7] shall not be set (0), 
indicating that increase is not 
allowed. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

FILE INCONSISTENT 





6.1.1.10.4 



Test Coverage 



CRR Number 


Test Case Number 


N1 


2,3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


P7 


10 


CI 


1 


C2 


11 


C3 


14 


C4 


12 


C5 


13 


C6, C7 


Not Tested 



6.1.1.11 Method invalidate 

Test Area Reference: API_1_SVW_INVL 

6.1 .1 .1 1 .1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void invalidate ( ) 

throws SIMViewException 



6.1.1.11.1.1 



Normal execution 



CRRNl; The currently selected EF of the calling applet shall be invalidated, i.e. the flag in the EF file status 
shall be changed accordingly. 



6.1.1.11.1.2 
No requirements. 

6.1.1.11.1.3 



Parameter errors 



Context errors 



CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

CRRC2: If the calling applet does not fulfil the access condition, INVALIDATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

CRRC3: If the currently selected EF is already invalidated, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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• CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.11.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.11.3 



API_1_S VW_INVL_1 .scr 
API_1_S VW_INVL_1 .Java 
API_1_S VW_INVL_1 .Idr 
API_1_S VW_INVL_1 .clr 
API_1_S VW_INVL_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF is selected 

1 - invalidate 


1 - Sliall throw 

Sim. access. SIMViewException with 

reason code NO EF SELECTED. 




2 


Invalidate EF 

1 - fid = DFSIMTEST 
select {) 

2 - fid = EFTNR 
select {) 

3 - invalidate 

4 - rehabilitate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 




3 


Access condition not fulfilled 

1 - fid = EFCNIV 
select {) 

2 - invalidate () 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED. 




4 


EF is already invalidated 

1 - fid = EFTNR 
select 

2 - invalidate 

3 - invalidate 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 





6.1.1.11.4 



Test Coverage 



CRR number 


Test Case Number 


N1 


2 


CI 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.1.12 Method rehabilitate 

Test Area Reference: API_1_SVW_REHA 
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6.1.1.12.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public void rehabilitate ( ) 

throws SIMViewException 



6.1.1.12.1.1 



Normal execution 



CRRNl: The currently selected EF of the calling applet shall be rehabilitated, i.e. the flag in the EF file status 
shall be changed accordingly. 



6.1.1.12.1.2 
No requirements. 

6.1.1.12.1.3 



Parameter errors 



Context errors 



• CRRCl : If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, REHABILITATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

• CRRC3: If the currently selected EF is not invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.12.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.12.3 



API_1_S VW_REHA_1 .scr 
API_1_S VW_REHA_1 .Java 
API_1_S VW_REHA_1 .Idr 
API_1_S VW_REHA_1 .cb- 
API_1_S VW_REHA_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF is selected 

1 - rehabilitate 


1 - Shall throw 

Sim. access. SIMViewException with 

reason code NO EF SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Rehabilitate invalidated File 

1 - fid = DFSIMTEST 
select 

2 - fid = EFCNR 
select 

3 - invalidate 

4 - rehabilitate 

5 - byte[] incr = new byte[3] = {0,0,1} 
incrOffset = 

byte [ ] resp = new byte[l] = 1 
respOffset = 
increase {) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 
resp[] shall contain {0,0,1}. 




3 


Access condition not fulfilled 

1 - fid = EFCNRH 
select 

2 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED.. 




4 


Rehabilitate validated File 

1 - fid = EFCNR 
select 

2 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

INVALIDATION STATUS CONTR 

ADICTION. 





6.1.1.12.4 



Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.2 Class SIMSystem 

6.1 .2.1 Method getTheSIMView 

Test Area Reference: API_1_SSY_GETS 

6.1.2.1.1 Conformance Requirement: 

The methoci with following header shall compliant to its definition in the API. 

public static SIMView getTheSIMView ( ) 

6.1.2.1.1.1 Normal execution 

• CRRNl: returns a reference to class which implements the SIMView interface. 

6.1.2.1.1.2 Parameters error 
No requirements. 

6.1.2.1.1.3 Context errors 
No requirements. 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.2.1.3 



API_1_SS Y_GETS_1 .scr 
API_l_SSY_GETS_l.java 
API_1_SS Y_GETS_1 .Idr 
API_1_SS Y_GETS_1 .clr 
API_1_SS Y_GETS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reference not equal null after execute 


The returned reference shall be not 
null after execute 




2 


reference to the GSM Interface 


Returned a reference to the GSM 
interface 





6.1.2.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 



6.1 .3 Class SIMViewException 

6.1.3.1 Method throwit 

Test Area Reference: API_1_SVE_THITS 

6.1.3.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public static void throwit (short reason) 
throws SIMViewException 

6.1.3.1.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of SIMViewException with the specified reason. 

• CRRN2: Extends javacard.framework.CardRuntimeException. 

6.1.3.1.1.2 Parameter errors 
No requirements. 

6.1.3.1.1.3 Context errors 
No requirements. 

6.1.3.1.2 Test Suite Files 

No additional requirements for the GSM personalization 
Test Script: API_l_SVE_THITS_l.scr 

Test Applet: API_l_SVE_THITS_l.java 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.1.3.1.3 



6.1.3.1.4 



API_1_S VE_THITS_1 .Idr 
API_1_S VE_THITS_1 .clr 
API_1_S VE_THITS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of 
SIIVIViewException with the specified reason 


Reason = 




2 


Throws the JCRE instance of 
SIIVIViewException with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of 
SIIVIViewException with the specified reason 


Reason = 15 




4 


SIIVIViewException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


SIIVIViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


SIIVIViewException extends 
javacard.framework.CardRuntimeException 


Reason = 15 





Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.1.3.2 Constructor 

Test Area Reference: API_1_SVE_C00RS 

6.1.3.2.1 Conformance Requirement: 

The method with following header shall compliant to its definition in the API. 

public SIMViewException (short reason) 
throws SIMViewException 

6.1 .3.2.1 .1 Normal execution 

• CRRNl: Construct a SIMViewException with the specified reason. 

6.1 .3.2.1 .2 Parameters error 
No requirements. 

6.1.3.2.1.3 Context errors 
No requirements. 

6.1.3.2.2 Test suite files 

No additional requirements for the GSM personalization 
Test Script: API_l_SVE_COORS_l.scr 

Test Applet: API_l_SVE_COORS_l.java 

Load Script: API_l_SVE_COORS.ldr 

Cleanup Script: API_l_SVE_COORS.clr 
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Parameter File: 



API_l_SVE_COORS.par 



6.1.3.2.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


SIMViewException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





6.1.3.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6.1.3.3 Reason Codes 

Test Area Reference: API_l_SVE_CONS 

6.1.3.3.1 Conformance Requirement: 

There is no API, only constants. This constants shall compliant to its definition in the API. 

6.1.3.3.1.1 Normal execution 

• CRRNl: The Constants of the class SIMViewException shall all have the same name and value defined in the 
3GPPTS 43.019 [7]. 

• CRRN2: Constructs SIMViewException a Exception with the specified reason. 



6.1.3.3.1.2 


Parameters error 


No requirements. 




6.1.3.3.1.3 


Context errors 


No requirements. 




6.1.3.3.2 


Test suite files 


None. 




6.1.3.3.3 


Test Procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed 



6.2 Package sim.toolkit 



6.2.1 



Interface ToolkitConstants 



6.2.1.1 Constants 

Test Area Reference: API_2_TKC_C0NS 
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6.2.1.1.1 Conformance Requirement 

There is no API, only constants. This constants shall be compare to its definition in the API. 

6.2.1.1.1.1 Normal execution 

• CRRNl: The Toolkit Constants shall all have the same name and value as defined in 3GPP TS 43.019 [7]. 



6.2.1.1.1.2 


Parameters er 


No requirements. 




6.2.1.1.1.3 


Context errors 


No requirements. 




6.2.1.1.2 


Test suite files 


None. 





6.2.1.1.3 



Test Procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.2 Interface Toolkitlnterface 
6.2.2.1 Method processToolkit 

Test Area Reference: API_2_TKI_PRTKB 

6.2.2.1.1 Conformance Requirement: 

The method with following prototype shall be compliant to its definition in the API. 

public void processToolkit (byte event) 
throws ToolkitException 



6.2.2.1.1.1 



Normal execution 



• CRRNl: This interface must be implemented by a Toolkit applet (which extends the javacard. framework. Applet 
class) so that it can be triggered by the Toolkit Handler according to the registration information. 

• CRRN2: The Toolkit applet will have to implement the processToolkit shared method so that the following 
events can be notified: 



Event 


Description 


EVENT_PROFILE_DOWNLOAD 


Terminal Profile command reception 


EVENT_FORMATTED_SMS_PP_ENV 


Formatted envelope SMS-PP Data Download 
reception 


EVENT_FORMATTED_SMS_PP_UPD 


Formatted Update Record EF SMS 


EVENT_FORI^TTED_SMS_CB 


Formatted envelope Cell Broadcast Data 
Download command reception 


EVENT_UNFORMATTED_SMS_PP_ENV 


Unformatted Envelope SMS-PP Data Download 
reception 


EVENT_UNFORMATTED_SMS_PP_UPD 


Unformatted Update Record EF SMS 


EVENT_UNFORIffiTTED_SMS_CB 


Unformatted Cell Broadcast Data Download 
command reception 


EVENT_MENU_SELECTION 


Envelope Menu Selection command reception 


EVENT_MENU_SELECTION_HELP_REQUEST 


Envelope Menu Selection Help Request 
command reception 


EVENT_CALL_CONTROL_B Y_S IM 


Envelope Call Control by SIM command reception 
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Event 


Description 


EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 


Envelope MO Short Message Control by SIM 
command reception 


EVENT_TIMER_EXPIRATION 


Envelope Timer Expiration 


EVENT_EVENT_DOWNLOAD_MT_CALL 


Envelope Event Download - MT call 


EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 


Envelope Event Download - Call connected 


EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 


Event Download - Call disconnected 


EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 


Envelope Event Download - Location status 


EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 


Envelope Event Download - User activity 


EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 


Envelope Event Download - Idle screen available 


EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


Envelope Event Download - Card Reader Status 


EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 


Envelope Event Download - Language Selection 


EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 


Envelope Event Download - Browser Termination 


EVENT_STATUS_COMMAND 


Status APDU command event 


EVENT_UNRECOGNIZED_ENVELOPE 


Unrecognized Envelope command reception 



6.2.2.1.1.2 

No requirements. 

6.2.2.1.1.3 

No requirements. 

6.2.2.1.2 



Parameters error 



Context errors 



Test suite files 



The method is tested in the Framework. 



6.2.2.1.3 



Test Coverage 



CRR number 


Test case number 


N1 


Tested in Framework 


N2 


Tested in Framework 



6.2.3 Class EditHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EnvelopeResponseHandler, ProactiveHandler. 

6.2.4 Class EnvelopeHandler 
6.2.4.1 Method getEnvelopeTag 

Test Area Reference: API_2_ENH_GENT 

6.2.4.1.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getEnvelopeTag ( ) 

6.2.4.1.1.1 Normal execution 

• CRRNl : The method shall return the Envelope BER-TLV tag. 

• CRRN2: The Envelope BER TAG is available for all triggered toolkit applets from the invocation to the 
termination of their processTooUcit method if the EnvelopeHandler is available. 
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6.2.4.1.1.2 

No requirements. 

6.2.4.1.1.3 

No requirements. 

6.2.4.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.1.3 



Parameters error 

Context errors 

Test suite files 

API_2_ENH_GENT_1 .scr 
API_2_ENH_GENT_1 .Java 
API_2_ENH_GENT_1 .Idr 
API_2_ENH_GENT_1 .clr 
API_2_ENH_GENT_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getEnvelopeTag called just after triggering of the 
application. 


Returns OxD1 




2 


getEnvelopeTag called after a proactive 
command. 


Returns OxD1 




3 


getEnvelopeTag called after a second proactive 
command. 


Returns OxD1 





6.2.4.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


1,2,3 



6.2.4.2 Method getltem Identifier 

Test Area Reference: API_2_ENH_GIID 

6.2.4.2.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

6.2.4.2.1.1 Normal execution 

• CRRNl:The method shall return the item identifier byte value. 

• CRRN2:The item identifier byte value returned shall be from the first Item Identifier TLV element. 

• CRRN3: If the element is available it becomes the TLV selected. 

• CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination of 
their processToolkit method if the EnvelopeHandler is available. 



6.2.4.2.1.2 

No requirements. 



Parameters error 
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6.2.4.2.1.3 



Context errors 



• CRRC 1 : The method shall throw ToolkitException (UN AV AILABLE_ELEMENT) if the item identifier TLV is 
not present. 

• CRRC2: The method shall throw ToolkitException (OUT_OF_TLV_BOUND ARIES) if the item identifier byte 
is missing in the Item Identifier Simple TLV. 



6.2.4.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.2.3 



Test suite files 

API_2_ENH_GIID_1 .scr 
API_2_ENH_GIID_1 .j ava 
API_2_ENH_G1ID_1 .Idr 
API_2_ENH_GIID_1 .clr 
API_2_ENH_GIID_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope SMS-PP Formatted with item 
identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope SIVIS-PP Formatted with two item 
identifier TLV with first value FF and second 44 


Returns FF 




3 


Send envelope SIVIS-PP Formatted with two item 
identifier TLV with first value 81 and second 44, 
call twice the method getltem Identifier 


Returns 81 
Returns 81 




4 


Send envelope SMS-PP Formatted with item 
identifier TLV and value of 66. FindTLV with TAG 
02. getltemldentifier and then getValueByte with 
offset 


getltem ldentifier=getValueByte 




5 


Send envelope SMS-PP Formatted without item 
identifier TLV and getltemldentifier 


ToolkitException 
(UNAVAILABLE ELEMENT) 




6 


Send Envelope SMS-PP Formatted with item 
identifier TLV (66), send proactive command. Then 
getltemldentifier 


Returns 66 




7 


Send Envelope SMS-PP Formatted with item 
identifier TLV but without item number 


ToolkitException 

(OUT OF TLV BOUNDARIES) 





6.2.4.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


2,3 


N3 


4 


N4 


6 


CI 


5 


C2 


7 



6.2.4.3 Method getSecuredDataLength 

Test Area Reference: API_2_ENH_GSDL 

6.2.4.3.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataLength ( ) 

throws ToolkitException 
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6.2.4.3.1.1 Normal execution 

• CRRN 1 : The method shall return the length of the secured data contained in a SMS TPDU TLV. 

• CRRN2: The length is from the first SMS TPDU TLV. 

• CRRN3: The length should not include padding bytes. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS 
TP-UD is formatted according to 3GPP TS 23.048 [8]. 

• CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS 
TP-UD is formatted according to 3GPP TS 23.048 [8]. 

• CRRN6: The method can be used if the event is EVENT_FORMATTED_SMS_CB and if the Cell Broadcast 
Page is formatted according to 3GPP TS 23.048 [8]. 

• CRRN7: If the method is successful and if the event is EVENT_FORMATTED_SMS_PP_ENV, the selected 
TLV should be the SMS TPDU TLV. 

• CRRN8: If the method is successful and if the event is EVENT_FORMATTED_SMS_CB, the selected TLV 
should be the Cell Broadcast Page TLV. 

6.2.4.3.1.2 Parameters error 
No requirements. 

6.2.4.3.1.3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (UN AVAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.3.2 Test suite files 

Specific triggering: 

- FORMATTED SMS CB. 

- UNFORMATTED SMS CB. 

- FORMATTED SMS PP UPD. 

- UNFORMATED SMS PP ENV. 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 

Test Script: API_2_ENH_GSDL_l.scr 

Test Applet: API_2_ENH_GSDL_l.java 

Load Script: API_2_ENH_GSDL_l.ldr 

Cleanup Script: API_2_ENH_GSLD_l.clr 

Parameter File: API_2_ENH_GSLD_1 .par 
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6.2.4.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with FORMATTED_SMS_PP_ENV and TP- 
OA length of 2 


Returns 0x2A 




2 


Test with TP-OA length of 6 


Returns 0x2A 




3 


Test with TP-OA length of 12 


Returns 0x2A 




4 


Test with RC/CC/DS length of 


Returns 0x10 




5 


Test with RC/CC/DS length of 8 


Returns 0x10 




6 


Test with PCNTR = 


Returns 0x10 




7 


Test with PCNTR = 7 


Returns 0x05 




8 


Test with SecuredDataLength = 00 


Returns 0x00 




9 


Test with UserDataLength = 0x33 


Returns 0x33 




10 


Test with UserDataLength = Ox 6C 


Returns Ox 6C 




11 


Test with UserDataLength = Ox 6D 


Returns Ox 6D 




12 


Test with UserDataLength = maximum length: 
0x79 


Returns Ox 79 




13 


Verify it is the first TPDU TLV: 

Send a SMS PP with 2 TPDU TLV and inside two 

different secured data lengths: 5 and 10 


Returns 0x05 




14 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




15 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




16 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




17 


Same test as 4 but with 
FORMA 1 IbD SMS PP UPD 


Returns 0x10 




18 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




19 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




20 


Same test as 7 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




21 


Same test as 8 but with 
FORMATTED SMS PP UPD 


Returns 0x00 




22 


Same test as 9 but with 
FORMATTED SMS PP UPD 


Returns 0x33 




23 


Same test as 1 but with 
FORMA 1 IbD SMS PP UPD 


Returns Ox 6C 




24 


Same test as 1 1 but with 
FORMA 1 IbD SMS PP UPD 


Returns Ox 6D 




25 


Same test as 1 2 but with 
FORMA 1 IbD SMS PP UPD 


Returns Ox 79 




26 


Same test as 13 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




27 


Same test as 4 but with FORMATTED SMS CB 


Returns 0x10 




28 


Same test as 5 but with FORMATTED SMS CB 


Returns 0x10 




29 


Same test as 6 but with FORMATTED SMS CB 


Returns 0x10 




30 


Same test as 7 but with FORMATTED SMS CB 


Returns 0x05 




31 


Same test as 8 but with FORMATTED SMS CB 


Returns 0x00 




32 


Same test as 9 but with FORMATTED SMS CB 


Returns 0x33 




33 


Same test as 12 but with maximum length: 0x42, 
and FORMA 1 IbD SMS CB 


Returns Ox 42 




34 


Test with FORMATTED_SMS_PP_ENV 
Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataLength 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


getValueByte returns 0x40 




35 


Test with FORMATTED_SMS_CB 

Verify after call of the method the current TLV is 

the Cell Broadcast Page TLV: 

findTLV device identities, getSecuredDataLength 

and then getValueByte to verify that the current 

TLV is the Cell Broadcast Page TLV 


getValueByte returns 0x58 
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Id 


Description 


API Expectation 


APDU Expectation 


36 


Send an envelope SMS CB, 
getSecuredDataLength 


ToolkitException 
UNAVAILABLE ELEMENT 




37 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.3.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during 3GPP TS 23.048 [8] tests. 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9, 10, 
11, 12, 13 


N2 


13 


N3 


6,7 


N4 


1,2,3,4,5,6,7,8,9, 10, 
11, 12, 13, 25 


N5 


14, 15, 16, 17, 18, 19,20, 
21,22,23,24,25,26 


N6 


27, 28,29, 30,31,32,33 


N7 


34 


N8 


35 


C1 


36 


C2 


37 



6.2.4.4 Method getSecuredDataOffset 

Test Area Reference: API_2_ENH_GSDO 

6.2.4.4.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataOf f set ( ) 

throws ToolkitException 

6.2.4.4.1.1 Normal execution 

• CRRNl: The method shall return the offset of the secured data first byte contained in a SMS TPDU TLV. 

• CRRN2: The offset is from the first SMS TPDU TLV. 

• CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP- 
UD is formatted according to [8]. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP- 
UD is formatted according to [8]. 

• CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_CB and if the Cell Broadcast 
Page is formatted according to [8]. 

• CRRN6: If the method is successful and if the event is EVENT_FORMATTED_SMS_PP_ENV, the selected 
TLV should be the SMS TPDU TLV. 

• CRRN7: If the method is successful and if the event is EVENT_FORMATTED_SMS_CB, the selected TLV 
should be the Cell Broadcast Page TLV. 



6.2.4.4.1.2 

No requirements. 



Parameters error 
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6.2.4.4.1.3 



Context errors 



• CRRC 1 : The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.4.2 Test suite files 

Specific triggering: 

- FORMATTED SMS CB. 

- UNFORMATTED SMS CB. 

- FORMATTED SMS PP UPD. 

- UNFORMATED SMS PP ENV. 

For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.4.3 



API_2_ENH_GSDO_l .scr 
API_2_ENH_GSDO_l .Java 
API_2_ENH_GSDO_l .Idr 
API_2_ENH_GSDO_l .clr 
API_2_ENH_GSDO_l .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x21 




2 


Test with TP-OA length of 6 


Returns 0x23 




3 


Test with TP-OA length of 1 2 


Returns 0x26 




4 


Test with RC/CC/DS length of 


Returns 0x21 




5 


Test with RC/CC/DS length of 8 


Returns 0x29 




6 


Send a SMS PP with 2 TPDU TLV and inside two 
different secured data offsets 


Returns 0x24 ( the first offset ) 




7 


Same test as 1 but with 
FORMAI IbD SMS PP UPD 


Returns 0x21 




8 


Same test as 2 but with 
FORMAI IbD SMS PP UPD 


Returns 0x23 




9 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x26 




10 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




11 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x29 




12 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x24 ( the first offset ) 




13 


Test with FORMATTED_SMS_PP ENV 

Verify after call of the method the current TLV is 

the TPDU TLV: 

findTLV device identities, getSecuredDataOffset 

and then getValueByte to verify that the current 

TLV is the TPDU TLV 


Returns 0x40 




14 


Same test as 4 but with FORMATTED SMS CB 


Returns 0x16 




15 


Same test as 5 but with FORMATTED SMS CB 


Returns 0x1 E 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Test with FORMATTED_SMS_CB 

Verify after call of the method the current TLV is 

the Cell Broadcast Page TLV: 

findTLV device identities, getSecuredDataOffset 

and then getValueByte to verify that the current 

TLV is the Cell Broadcast Page TLV 


Returns 0x58 




17 


Send an UNFORMATTED SMS CB envelope, 
getSecu red DataOffset 


ToolkitException 
UNAVAILABLE ELEMENT 




18 


Send an UNFORMATTED SMS PP envelope 


ToolkitException 
UNAVAILABLE ELEMENT 




19 


Send an FORMATTED SMS-PP envelope with no 
secured data, getSecuredDataOffset 


Returns 0x21 





6.2.4.4.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during TS 23.048 [8] tests. 



CRR number 


Test case number 


N1 


1,2,3,4,5,6, 19 


N2 


6, 12 


N3 


1,2,3,4,5,6,19 


N4 


7,8,9, 10, 11 


N5 


14,15 


N6 


13 


N7 


16 


CI 


17 


C2 


18 



6.2.4.5 Method getTheHandler 

Test Area Reference: API_2_ENH_GTHD 

6.2.4.5.1 Conformance Requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkitException 

6.2.4.5.1.1 Normal execution 

• CRRNl: The method shall return the single system instance of the EnvelopeHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]) 

6.2.4.5.1.2 Parameters error 
No requirements. 

6.2.4.5.1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (H ANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.4.5.2 Test suite files 

Test Script: API_2_ENH_GTHD_l.scr 

Test Applet: API_2_ENH_GTHD_l.java 

Load Script: API_2_ENH_GTHD_l.ldr 
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Cleanup Script: 
Parameter File: 

6.2.4.5.3 



API_2_ENH_GTHD_1 .clr 
API_2_ENH_GTHD_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify tliat getTheHandler returns an 

EnvelopeHandler 

GetTheHandler 


The reference returned shall be an 
EnvelopeHandler (checkcast) 




3 


Verify the returned value is not null 
GetTheHandler 


The reference returned shall not be 
null. 





6.2.4.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in Framework tests and insert here cross reference 


01 


To be checked in Framework tests and insert here cross reference 



6.2.4.6 Method getTPUDLOffset 

Test Area Reference: API_2_ENH_GTPO 

6.2.4.6.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getTPUDLOf f set ( ) 

throws ToolkitException 

6.2.4.6.1.1 Normal execution 

• CRRN 1 : The method shall return the TPUDL offset in a SMS TPDU TLV. 

• CRRN2: The offset is from the first SMS TPDU TLV. 

• CRRN3: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD. 

• CRRN5: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_ENV. 

• CRRN6: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_UPD. 

• CRRN7: If the method is successful, the selected TLV should be the SMS TPDU TLV. 



6.2.4.6.1.2 

No requirements. 

6.2.4.6.1.3 



Parameters error 



Context errors 



• CRRC 1 : The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) if the TPUDL field does 
not exist. 
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Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.6.3 



API_2_ENH_GTP0_1 .scr 
API_2_ENH_GTPO_l .Java 
API_2_ENH_GTPO_l .Idr 
API_2_ENH_GTPO_l .clr 
API_2_ENH_GTPO_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns OxOD 




2 


Test with TP-OA length of 6 


Returns OxOF 




3 


Test with TP-OA length of 12 


Returns 0x1 2 




4 


Send a SMS PP with 2 TPDU TLV and inside two 
different DDL offsets 


Returns 0x1 ( the first offset ) 




5 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns OxOD 




6 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns OxOF 




7 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x1 2 




8 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x1 ( the first offset ) 




9 


Same test as 1 but with 
UNFORMAI IbD SMS PP UPD 


Returns OxOD 




10 


Same test as 2 but with 
UNFORMAI IbD SMS PP UPD 


Returns OxOF 




11 


Same test as 3 but with 
UNFORMAI IbD SMS PP UPD 


Returns 0x1 2 




12 


Same test as 4 but with 
UNFORMAI IbD SMS PP UPD 


Returns 0x1 2 ( the first offset ) 




13 


Same test as 1 but with 
UNFORMAI IbD SMS PP ENV 


Returns OxOD 




14 


Same test as 2 but with 
UNFORMAI IbD SMS PP ENV 


Returns OxOF 




15 


Same test as 3 but with 
UNFORMAI IbD SMS PP ENV 


Returns 0x1 2 




16 


Same test as 4 but with 
UNFORMAI IbD SMS PP ENV 


Returns 0x1 ( the first offset ) 




17 


Verify after call of the method the current TLV is the 
TPDU TLV: 

findTLV device identities, getTPUDLOffset and then 
getValueByte to verify that the current TLV is the 
TPDU TLV 


Returns 0x40 




18 


Send an envelope SMS CB, getTPUDLOffset 


ToolkitException 
UNAVAILABLE ELEMENT 
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6.2.4.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 16, 17 


N2 


4 


N3 


1,2,3,4, 17 


N4 


5, 6, 7, 8 


N5 


13, 14, 15, 16 


N6 


9, 10, 11, 12 


N7 


17 


C1 


18 


C2 


Don't no how to test 



6.2.4.7 Method getLength 

Test Area Reference: API_2_ENH_GLEN 

6.2.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.4.7.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.4.7.1.2 Parameter Error 
No requirements. 

6.2.4.7.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.4.7.2 Test Suite files 
Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.7.3 



API_2_ENH_GLEN_1 .scr 
API_2_ENH_GLEN_1 .Java 
API_2_ENH_GLEN_1 .Idr 
API_2_ENH_GLEN_1 .clr 
API_2_ENH_GLEN_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send an envelope SMS PP with BER length of 0x31 


Result of getLengthO is 0x0031 




2 


Send an envelope SMS PP with BER length of 0x7F 


Result of getLengthO is 0x007Fh 




3 


Send an envelope SMS PP with BER length of 81 80 


Result of getLengthO is OxOOSOh 




4 


Send an envelope SMS PP with BER length of 81 PC 


Result of getLengthO is OxOOFCh 
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6.2.4.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


C1 


Does not apply for 
EnvelopeHandler 



6.2.4.8 Method copy 

Test Area Reference: API_2_ENH_C0PY_BSS 



6.2.4.8.1 



Conformance Requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.4.8.1.1 Normal execution 

• CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.4.8.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUNDARlES. 



6.2.4.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.8.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.8.3 



API_2_ENH_COPY_BSS_Lscr 
API_2_ENH_C0PY_BSS_1 .Java 
API_2_ENH_COPY_BSS_l .Idr 
API_2_ENH_COPY_BSS_l .clr 
API_2_ENH_COPY_BSS_l .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


dstOffset > dstBuffer.length 

dstBuffer. length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the simple TLV list 

DstBuffer.length = 48 
DstOffset = 
DstLength = 48 


Tooll<itException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 0X0009 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 260 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X01 04 




15 


Compare the whole buffer 


Result of arrayCompareO is 




16 


Successful call, copy with length =0 

dstBuffer.length = 260 
dstOffset = 260 
dstLength = 


Result of copyO is 0x104 





6.2.4.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


P1 


1 


P2 


2,3,4,5,6 


P3 


7 


C1 


Does not apply for EnvelopeHandler 



6.2.4.9 Method findTLV 

Test Area Reference: API 2 ENH FINDBB 
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6.2.4.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV(byte tag, byte occurrence) 
throws ToolkitException 

6.2.4.9.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 

is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.4.9.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 



6.2.4.9.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.9.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.9.3 



API_2_ENH_ENH_FINDBB_1 .scr 
API_2_ENH_ENH_FINDBB_1 .Java 
API_2_ENH_ENH_FINDBB_1 .Idr 
API_2_ENH_FINDBB_1 .ck 
API_2_ENH_FINDBB_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Trig the applet with SMS PP including one more 
tag 02 and one TAG 04 






1 


Invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 




2 


Search 1st TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 0x02 




4 


Search 2nd TLV 

Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is OxOSh 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



74 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = 02h 
Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




10 


Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





6.2.4.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7, 8, 9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for EnvelopeHandler 



6.2.4.10 Method getValueLength 

Test Area Reference: API_2_ENH_GVLE 

6.2.4.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 



6.2.4.10.1.1 



Normal execution 



• CRRNl: gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



6.2.4.10.1.2 
No requirements. 

6.2.4.10.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 
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Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.10.3 



API_2_ENH_GVLE_1 .scr 
API_2_ENH_GVLE_1 .Java 
API_2_ENH_GVLE_1 .Idr 
API_2_ENH_GVLE_1 .clr 
API_2_ENH_GVLE_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 






1 


getValueLengthO 


ToolkitExceptlon . UNAVAI LABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 








getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 








getValueLength ( ) 


Result is 0X00C8 





6.2.4.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4 


CI 


Does not apply for EnvelopeHandler 


C2 


1 



6.2.4.1 1 Method getValueByte 

Test Area Reference: API_2_ENH_GVBYS 

6.2.4.11.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitExceptlon 



6.2.4.11.1.1 



Normal execution 



• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 



6.2.4.11.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitExceptlon shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.4.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooMtException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.11.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.11.3 



API_2_ENH_GVBYS_1 .scr 
API_2_ENH_GVBYS_1 .Java 
API_2_ENH_GVBYS_l.dr 
API_2_ENH_GVB YS_1 .clr 
API_2_ENH_GVB YS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 
Value 01 02... 






1 


getValueByte{0) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueByte(2) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 




5 


Search TLV 33h 








getValueByte (7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xC8 





6.2.4.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for EnvelopeHandler 


C2 


1 



6.2.4.12 Method copyValue 

Test Area Reference: API_2_ENH_CPYVS_BSS 



6.2.4.12.1 



Conformance Requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java. lang. Array I ndexOutOfBoundsExcept ion, 
ToolkitException 
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6.2.4.12.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.4.12.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.4.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.12.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.12.3 



API_2_ENH_CPYVS_BSS_1 .scr 
API_2_ENH_CPYVS_BSS_1 .Java 
API_2_ENH_CPYVS_BSS_1 .Idr 
API_2_ENH_CPYVS_BSS_1 .clr 
API_2_ENH_CPYVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > TLV length 

valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 








copyValue () 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown on the 
copyValueO method 




12 


Search TLV 06h 








Successful call 

valueOffset = 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


Result of copyValueO is 0x0006 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 1 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyValueO is 0x0007 




15 


Compare buffer 

buffer = 
55 55 55 11 22 
33 44 55 55 55 
55 55 55 55 55 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.4.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


13,15 


N2 


12, 14, 16 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


C1 


Does not apply for EnvelopeHandler 


C2 


11 



6.2.4.13 Method compareValue 

Test Area Reference: API_2_ENH_CPRVS_BSS 
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6.2.4.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf f er, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.4.13.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.4.13.1.2 Parameter errors 

• CRRP 1 : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.4.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.13.2 Test Suite files 
Specific triggering: None 

Test Script: API_2_ENH_CPRVS_BSS_l.scr 

Test Applet: API_2_ENH_CPRVS_BSS_l.java 

Load Script: API_2_ENH_CPRVS_BSS_l.ldr 

Cleanup Script: API_2_ENH_CPRVS_BSS_l.clr 

Parameter File: API_2_ENH_CPRVS_BSS_1 .par 



6.2.4.13.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








compareValue ( ) with a null compareBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareBuf fer . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


compareOffset < 

compareBuff er . length = 5 
compareOffset = -1 
compareLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

compareBuff er . length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset = 6 
compareBuffer . length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer . length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

valueOffset = 
compareBuffer . length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

valueOffset = 2 
compareBuffer . length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 






compareValue () 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


Search TLV 06h 








Initialize compareBuffer 

compareBuffer = 
81 11 22 33 44 F5 








Compare buffers 

valueOffset = 
compareOffset = 
compareLength = 6 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
7F 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








Compare buffers 

valueOffset = 1 
compareOffset = 4 
compareLength = 5 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 10 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Initialize compareBuffer 

compareBuf f er = 

55 55 55 81 12 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareValue with length =o 

CompareBuf fer . length = 15 
CompareOf f set = 15 
CompareLength = 


Result of compareValueO is 





6.2.4.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16, 18 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


C1 


Does not apply for EnvelopeHandler 


C2 


11 



6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: API_2_ENH_FACYB_BS 

6.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[l dstBuffer, 

short dstOffset) 
throws Java . lang . NullPointerException, 
Java -lang . ArraylndexOutOfBoundsException, 

ToolkitException 



6.2.4.14.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.4.14.1.2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.4.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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6.2.4.14.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_FACYB_BS_l.scr 

Test Applet: API_2_ENH_FACYB_BS_l.java 

Load Script: API_2_ENH_FACYB_BS_l.ldr 

Cleanup Script: API_2_ENH_FACYB_BS_l.clr 

Parameter File: API_2_ENH_FACYB_BS_l.par 



6.2.4.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h 

dstBuffer.length = 06 
dstOffset = 06 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 06 

dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 06 

DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

Tag = 06h 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue () is 
0006 




8 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 12 
dstOffset = 2 


Result of findAndCopyValue () is 
0008 




10 


Compare buffer 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Result is OOh 




11 


Successful call 

tag = 02h 

dstBuffer.length = 2 
dstOffset = 


Result of findAndCopyValue () is 
0002 




12 


Compare buffer 

buffer = 83 81 


Result is OOh 




13 


Successful call (with tag 82h) 

tag = 82h 

dstBuffer.length = 02 
dstOffset = 


Result of findAndCopyValue () is 
0002 




14 


Compare buffer 

buffer = 83 81 


Result is OOh 




15 


Successful call (with tag B3h) 

tag = B3h 

dstBuffer.length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 





6.2.4.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for EnvelopeHandler 



6.2.4.15 



Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 



Test Area Reference: API 2 ENH FACYBS BSS 



6.2.4.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 



6.2.4.15.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4; The search method is comprehension required flag independent. 

6.2.4.1 5.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.4.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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6.2.4.15.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.15.3 



Test Suite files 

API_2_ENH_FACYBS_BSS_1 .scr 
API_2_ENH_FACYBS_BSS_1 .Java 
API_2_ENH_FAC YBS_BSS_1 .Idr 
API_2_ENH_FAC YBS_BSS_1 .clr 
API_2_ENH_FACYBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCopyValueO with a null dstBuffer 


NullPointerException Is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Array 1 ndexOutOfBou ndsExceptIo 
n Is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptIo 
n Is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Value length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES is thrown 




11 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 06h 
occurrence = 2 


ToolkltExceptlon. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkltExceptlon. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Successful call 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer. length = 06 
dstOffset = 
dstLength = 06 


Result of fincJAndCopyValueQ is 6 




13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = 06h, occurrence = 1 
valueOffset = 2 
dstBuffer. length = 12 
dstOffset = 3 
dstLength = 04 


Result of findAndCopyValue () is 
0007 




15 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




16 


Successful call 

tag = 02h, occurrence = 1 
valueOffset = 
dstBuffer .length = 12 
dstOffset = 
dstLength = 2 


Result of findAndCopyValueQ is 
0002 




17 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 




18 


Successful call 

tag = 02h, occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 2 


Result of findAndCopyValueQ is 
0002 




19 


Compare buffer 

buffer = 22 44 55 ... 55 


Result is OOh 




20 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 1 
valueOffset = 
dstBuffer .length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




21 


Compare buffer 

buffer = 83 81 55 ... 55 


Result is OOh 




22 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 2 
valueOffset = 
dstBuffer .length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




23 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 




24 


Successful call, findAndCopyValue with length 
=0 

DstBuffer. length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue () is 
12 





6.2.4.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20,21, 22,23 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for EnvelopeHandler 
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6.2.4.16 Method findAndCompareValue(byte tag, byteQ compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ENH_FACRB_BS 

6.2.4.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.4.16.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

6.2.4.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

6.2.4.16.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.16.2 Test Suite files 

Test Script: API_2_ENH_FACRB_BS_l.scr 

Test Applet: API_2_ENH_FACRB_BS_l.java 

Load Script: API_2_ENH_FACRB_BS_l.ldr 

Cleanup Script: API_2_ENH_FACRB_BS_l.clr 

Parameter File: API_2_ENH_FACRB_BS_l.par 
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6.2.4.16.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 12 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








Compare buffers 

tag = 06h 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 06 




9 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




10 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




12 


Initialize compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 

55 55 83 80 55 55 55 55 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is +1 




14 


Initialize compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

tag = 02h 

compareBuffer.length = 12 
compareOffset = 


Result is OOh 




16 


Initialize compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

Tag = B3h 

CompareBuffer.length = C4 
CompareOffset = 


Result is OOh 
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6.2.4.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for EnvelopeHandler 



6.2.4.17 



Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 



Test Area Reference: API_2_ENH_FACRBBS_BSS 

6.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



6.2.4.17.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.4.17.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.4.17.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.4.17.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.17.3 



Test Suite files 

API_2_ENH_FACRBBS_BSS_1 .scr 
API_2_ENH_FACRBBS_BSS_1 .Java 
API_2_ENH_FACRBBS_BSS_1 .Idr 
API_2_ENH_FACRBBS_BSS_1 .clr 
API_2_ENH_FACRBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SIMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 6 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 6 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = 06h 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown. 




13 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F5 








findAndCompareValueQ 

tag = 06h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




15 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




16 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 4 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 

22 44 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 

22 45 55 55 55 55 55 55 55 55 55 55 








findAndCompareValueQ 

tag = 02h, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 2 


Result is -1 




23 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








Successful call (with tag 02h) 

tag = 02h, occurrence = 1 
valueOffset = 
compareBuffer . length = 12 
compareOf f set = 
compareLength = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


Initialize compareBuffer 

compareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

tag = B3h, occurrence = 1 
valueOffset = 
compareBuffer . length = 00C4 
compareOf f set = 
compareLength = 00C4 


Result is OOh 




25 


Successful call, findAndCompareValue with 
length =0 

DstBuffer. length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueO 
is OOh 





6.2.4.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21,25 


N4 


19,15 


N5 


16, 18,22 


N6 


23,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


CI 


Does not apply for EnvelopeHandler 



6.2.5 Class EnvelopeResponseHandler 
6.2.5.1 Method getTheHandler 

Test Area Reference: API_2_ERH_GTHD 

6.2.5.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeResponseHanciler getTheHandler ( ) 

throws ToolkitException 

6.2.5.1.1.1 Normal execution 

• CRRNl: The method shall return the single system instance of the EnvelopeResponseHandler class. 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2. 1 Runtime 
Environment (JCRE) Specification [12]). 

6.2.5.1.1.1 Parameter errors 

No requirements. 

6.2.5.1.1.3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (H ANDLER_NOT_A V AILABLE) if the handler is busy. 

• CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no 
more available 
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6.2.5.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.1.3 



Test suite files 

API_2_ERH_GTHD_1 . scr 
API_2_ERH_GTHD_1 .j ava 
API_2_ERH_GTHD_1 .Idr 
API_2_ERH_GTHD_1 .clr 
API_2_ERH_GTHD_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 

getTheHandler 


The reference returned shall be an 

EnvelopeResponseHandler 

(checkcast) 




3 


Verify the returned value is not null 

getTheHandler 


The reference returned shall not be 
null. 




4 


getTheHandler, then send a proactive 
command, and then, appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





6.2.5.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in Framework tests and insert here cross reference 


C1 


To be checked in Framework tests and insert here cross reference 


C2 


4 



6.2.5.2 Method post 

Test Area Reference: API_2_ERH_POSTB 

6.2.5.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void post (byte statusType) 
throws ToolkitException 



6.2.5.2.1.1 



Normal execution 



CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command). 

CRRN2: The byte statusType is SWl of the status. 

CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME. 

CRRN4: The SIM Toolkit Framework shall take the optional Application Data posted by the triggered toolkit 
applet if present, secure and send the response packet the SIM Toolkit Framework will return the response 
APDU defined by the toolkit applet. 



6.2.5.2.1.2 

No requirements. 



Parameter error 
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6.2.5.2.1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (H ANDLER_NOT_A V AILABLE) if the handler is busy. 

6.2.5.2.2 Test suite files 
Specific triggering: Call control 

Test Script: API_2_ERH_POSTB_l.scr 

Test Applet: API_2_ERH_POSTB_l.java 

Load Script: API_2_ERH_POSTB_l .Idr 

Cleanup Script: API_2_ERH_POSTB_l .clr 

Parameter File: API_2_ERH_POSTB_l .par 



6.2.5.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then post 

(the handler is empty) 




9000 


2 


Fill the handler ( appendTLV to have bytes 

in it ) and then post data with status 
9F 




9FFD data are retrieved with GET 
RESPONSE command 


3 


Verify that after a post the handler is no 
more available 

appendTLV, post and then appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown on the second 
appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and post it with status 9E and 

then send a display text 




9E12 and posted data retrieved by a 
GET RESPONSE with status 911 3 
and display text retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post 

getTheHandler and post , then send a 
display text 




9113 and display text is retrieved by 
a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandler, appendTLV, send a 
display text, post. 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 




7 


Verify that the handler is no more available 
after a post 

getTheHandler, appendTLV, post with 
status 9E, post with status 9F 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 


9E12 and posted data retrieved by a 
GET RESPONSE 



6.2.5.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


1,2,4,7 


N3 


4,5 


N4 


To be checked in Framework tests and insert here cross reference 


C1 


6 



6.2.5.3 Method postAsBERTLV 

Test Area Reference:API 2 ERH POSTBB 
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6.2.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV (byte statusType, 

byte tag) 
throws ToolkitException 



6.2.5.3.1.1 



Normal execution 



• CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet. 

• CRRN2: The byte statusType is SWl of the status 

• CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the 
ME. 

• CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV list. 

6.2.5.3.1 .2 Parameter errors 
No requirements. 

6.2.5.3.1.3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (H ANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.5.3.2 Test suite files 

Specific triggering: Call control 

Test Script: API_2_ERH_P0STBB_l.scr 

API_2_ERH_P0STBB_1 .Java 

API_2_ERH_POSTBB_l .Idr 

API_2_ERH_POSTBB_l .clr 

API_2_ERH_POSTBB_l .par 

Test procedure 



Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.3.3 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then postAsBERTLV 

(the handler is empty) 




9F02 data are retrieved with 

GET RESPONSE command, 

the tag shall be 33 and the 

length is 00 


2 


Fill the handler and then postAsBERTLV 
the data with status 9F, and tag 33 




9FFF data are retrieved with 

GET RESPONSE command, 

the tag shall be 33 


3 


appendTLV, postAsBERTLV and then 
appendTLV 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the second appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and postAsBERTLV it with 

status 9E, tag 75 and then send a display 

text 




9E14and posted data 

retrieved by a GET 

RESPONSE the tag shall be 

75 with status 9113 and 

display text retrieved by a 

FETCH 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


getTheHandler and postAsBERTLV, then 
send a display text 




9E02 and posted data 

retrieved by a GET 

RESPONSE the tag 33 (and 

the length 00) with status 

9113 and display text is 

retrieved by a FETCH 


6 


Verify it is not possible to postAsBERTLV 
after a proactive command 

getTheHandler, appendTLV, send a 
display text, postAsBERTLV. 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLV 

getTheHandler, appendTLV (with data 
length = 0x10, postAsBERTLV with status 
9E, tag 56, postAsBERTLV with status 
9F, tag 28 


ToolkitException 

HANDLER_NOT_AVAILABLE is 

thrown on the second postAsBERTLV 


9E14and posted data 

retrieved by a GET 

RESPONSE the tag shall be 

56 with status 9000 



6.2.5.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,7 


N2 


1,2,4,7 


N3 


4,5 


N4 


2,4,7 


C1 


6 



6.2.5.4 Method getLength 

Test Area Reference: API_2_ERH_GLEN 

6.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.5.4.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.5.4.1 .2 Parameter errors 
No requirements. 

6.2.5.4.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AIL ABLE. 

6.2.5.4.2 Test Suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_GLEN_l.scr 

Test Applet: API_2_ERH_GLEN_l.java 

Load Script: API_2_ERH_GLEN_l.ldr 

Cleanup Script: API_2_ERH_GLEN_l.clr 
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Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO is 




2 


appendTLV with length of 7 

getLength () 


Result of getLengthO is 9 




3 


Clear the handler and appendTLV with Length 
of 250 

getLength {) 


Result of getLengthO is 253 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLengthO is 81 h 




5 


Build a 80h Envelope response handler 

getLength {) 


Result of getLengthO is 83h 




NOTE: Test case 3 is limited to 253 and not 256 because tlie current 3GPP TS 43.01 9 [7 
point. So this test allows the two possible implementations. 


is not clear enough on this 



6.2.5.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


Does not apply for Envelope response handler 



6.2.5.5 Method copy 

Test Area Reference: API 2 ERH COPY BSS 



6.2.5.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.5.5.1.1 Normal execution 

• CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.5.5.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 



6.2.5.5.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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6.2.5.5.2 Test Suite files 

Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_COPY_BSS_l.scr 

Test Applet: API_2_ERH_COPY_BSS_l.java 

Load Script: API_2_ERH_COPY_BSS_l.ldr 

Cleanup Script: API_2_ERH_COPY_BSS_l.clr 

Parameter File: API_2_ERH_COP Y_BSS_1 .par 



6.2.5.5.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with value length of 7 
NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 5 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 
dstLength = 10 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer Is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copyO is 15 
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6.2.5.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for Envelope response handler 



6.2.5.6 Method findTLV 

Test Area Reference: API_2_ERH_FINDBB 

6.2.5.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.5.6.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 

is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.5.6.1 .2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 



6.2.5.6.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.6.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



API_2_ERH_FINDBB_1 .scr 
API_2_ERH_FINDBB_l.java 
API_2_ERH_FINDBB_1 .Idr 
API_2_ERH_FINDBB_1 .clr 
API_2_ERH_FINDBB_1 .par 
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6.2.5.6.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Invalid input parameter 

Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




2 










Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result Is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown. 




10 


Append a TLV with tag=:02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 





6.2.5.6.4 



Test Coverage 



CRR number 


Test case number 


Ml 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for Envelope response handler 



6.2.5.7 Method getValueLength 

Test Area Reference: API_2_ERH_GVLE 

6.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 
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6.2.5.7.1.1 



Normal execution 



• CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



6.2.5.7.1.2 

No requirements. 

6.2.5.7.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.7.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.7.3 



API_2_ERH_GVLE_Lscr 
API_2_ERH_GVLE_1 .Java 
API_2_ERH_GVLE_1 .Idr 
API_2_ERH_GVLE_1 .clr 
API_2_ERH_GVLE_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 02 02 02 02 
findTLV with TAG 03 








getValueLengthQ 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown 




2 


appendTLV with TAG OD and length 00 








Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and append TLV with TAG 
OD and length 0x7F 








Search TLV ODh 








getValueLengthO 


Result is 7Fh 




5 


Clear the handler and append TLV with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength ( ) 


Result is 80h 




6 


Clear the handler and append TLV with TAG 
OD and length OxFI 








Search TLV ODh 








getValueLength ( ) 


Result is Flh 
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6.2.5.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


1 



6.2.5.8 Method getValueByte 

Test Area Reference: API_2_ERH_GVBYS 

6.2.5.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



6.2.5.8.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 



6.2.5.8.1.2 



Parameter errors 



• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.5.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.8.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.8.3 



API_2_ERH_GVB YS_1 .scr 
API_2_ERH_GVBYS_1 .Java 
API_2_ERH_GVB YS_1 .Idr 
API_2_ERH_GVB YS_1 .clr 
API_2_ERH_GVB YS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 82 02 81 82, appendTLV 81 03 1 1 

22 FE 

findTLV with TAG 03 








getValueByte (0) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Search TLV 01 h 








getValueByte(2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLV with TAG OD, Length 0x7E, Value: 
00,01,...,7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLV with TAG OD, 
Length 0x80, Value: 00, 01, ..., 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 




8 


Clear the handler, appendTLV with TAG OD, 
Length OxFI, Value: 00, 01, ..., FO 








getValueByte (FO) 


Result is FOh 





6.2.5.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for EnvelopeResponseHandler 


C2 


1 



6.2.5.9 Method copyValue 

Test Area Reference: API_2_ERH_CPYVS_BSS 

6.2.5.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.5.9.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.5.9.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.5.9.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AV AIL ABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooMtException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.9.2 Test Suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_CPYVS_BSS_l.scr 

Test Applet: API_2_ERH_CPYVS_BSS_l.java 

Load Script: API_2_ERH_CPYVS_BSS_l.ldr 

Cleanup Script: API_2_ERH_CPYVS_BSS_l.clr 

Parameter File: API_2_ERH_CPYVS_BSS_1 .par 



6.2.5.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler, appendTLV with TAG: OD 

and length 6 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize the handler 








copyValue () 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


clear the handler, appendTLV with TAG: OD 

and value: 04 00 01 ...OF 

Select Text String TLV 








Successful call 

valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Successful call, copyValue with length =0 

dstBuffer .length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.5.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9,10 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


11 



6.2.5.10 Method compareValue 

Test Area Reference: API_2_ERH_CPRVS_BSS 



6.2.5.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 



6.2.5.10.1.1 Normal execution 

Compares the last found TLV element with a buffer: 
• CRRN 1 : returns if identical. 
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• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.5.10.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.5.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.10.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.10.3 



API_2_ERH_CPRVS_BSS_Lscr 
API_2_ERH_CPRVS_BSS_1 .Java 
API_2_ERH_CPRVS_BSS_1 .Idr 
API_2_ERH_CPRVS_BSS_1 .clr 
API_2_ERH_CPRVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


appendTLV with TAG: OD and lengtli 6 
Select Text String TLV 








valueOffset > Text String Lengtli 

valueOffset = 6 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValue () 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown 




12 


appendTLV with TAG: OD and value: 04 00 01 

...OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Successful call, compareValue with length =0 

compareBuff er . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValueO is 





6.2.5.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15, 18 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


11 



6.2.5.1 1 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference: API_2_ERH_FACYB_BS 

6.2.5.11.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang . NullPointerExceptlon, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkltException 



6.2.5.11.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.5.11.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerExceptlon shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.5.11.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkltException HANDLER_NOT_AVAILABLE. 
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6.2.5.11.2 Test Suite files 

Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_FACYB_BS_l.scr 

Test Applet: API_2_ERH_FACYB_BS_l.java 

Load Script: API_2_ERH_FACYB_BS_l.ldr 

Cleanup Script: API_2_ERH_FACYB_BS_l.clr 

Parameter File : API_2_ERH_FAC YB_B S_ 1 .par 



6.2.5.11.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








fIndAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


appendlLV with TAG: OD and length 16 
Select Text String TLV 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Clear the handler, appendTLV with TAG 02 and 
Length 02 








Select a TLV (tag 02h) 








findAndCopyValue () 
tag = 03h 


Tooll<itException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException.UNAVAILABLE_ 
ELEIVIENT is thrown. 




7 


appendTLV with TAG: OD and value: 04 00 01 
...OF 








Successful call 

Tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueQ is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ...OF 








append a 2™ Text String TLV 








Successful call 

tag = ODh 

dstBuffer. length = 17 

dstOffset = 


Result of findAndCopyValueQ is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ...OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuffer. length = 17 

dstOffset = 


Result of findAndCopyValueQ is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuffer . length = 16 

dstOffset = 


Result of findAndCopyValueQ is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.5.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.5.1 2 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 



Test Area Reference: API_2_ERH_FACYBBS_BSS 



6.2.5.12.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



6.2.5.12.1.1 



Normal execution 



CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 
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• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.5.12.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.5.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.12.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.12.3 



API_2_ERH_FACYBBS_BSS_1 .scr 
API_2_ERH_FACYBBS_BSS_1 .Java 
API_2_ERH_FAC YBBS_BSS_1 .Idr 
API_2_ERH_FACYBBS_BSS_1 .clr 
API_2_ERH_FACYBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








fincJAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


appendTLV with TAG: OD and length 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer .length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer .length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Clear the handler, appendTLV with TAG 02 and 
Length 02 








Select a TLV (tag 02h) 








findAndCopyValue () 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLength method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




12 


Clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndCopyValueQ is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer .length = 20 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueQ is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueQ is 6 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValue () is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = BFh 
occurrence = 1 
valueOffset = 
dstBuffer . length = 16 
dstOffset = 
dstLength =16 


Result of findAndCopyValue () is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Successful call, findAndCopyValue with length 
=0 

dstBuffer .length = 16 
dstOffset = 16 
dstLength = 


Result of findAndCopyValue () is 
16 





6.2.5.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18,24 


N4 


20,21,22,23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.5.13 



Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 



Test Area Reference: API_2_ERH_FACRB_BS 

6.2.5.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.5.13.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 
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• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns L 

• CRRN6: The search method is comprehension required flag independent. 

6.2.5.13.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.5.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AV AIL ABLE. 

6.2.5.13.2 Test Suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.13.3 



API_2_ERH_FACRB_BS_1 .scr 
API_2_ERH_FACRB_BS_1 .Java 
API_2_ERH_FACRB_BS_1 .Mr 
API_2_ERH_FACRB_BS_1 .clr 
API_2_ERH_FACRB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 








findAndCompareVaiueQ with a null dstBuffer and 
tag ODh 


NullPointerException is thrown 




2 










compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV with TAG 02 and 
Length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOf f set = 


Result is OOh 




9 


Verify current TLV 

getValueLength ( ) 


Result is 17 




10 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




12 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




13 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is -1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

compareOffset = 2 


Result is +1 




16 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 

compareOffset = 


Result is OOh 




17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 

compareOffset = 


Result is OOh 
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6.2.5.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


6,7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11, 15 


N6 


17, 16 


PI 


1 


P2 


2,3,4,5 


CI 


Does not apply for Envelope response handler 



6.2.5.14 



Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 



Test Area Reference: API 2 ERH FACRBBS BSS 



6.2.5.14.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte [ ] compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang.NullPointerException, 

Java . lang . Array I ndexOut Of Bounds Except ion. 
Toolkit Except ion 



6.2.5.14.1.1 



Normal execution 



Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.5.14.1.2 Parameter errors 

• CRRP 1 : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.5.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

6.2.5.14.2 Test Suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_FACRBBS_BSS_l.scr 

Test Applet: API_2_ERH_FACRBBS_BSS_l.java 

Load Script: API_2_ERH_FACRBBS_BSS_l.ldr 

Cleanup Script: API_2_ERH_FACRBBS_BSS_l.clr 

Parameter File: API_2_ERH_FACRBBS_BSS_1 .par 



6.2.5.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler and appendTLV with TAG 
and length of 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




12 


appendTLV with TAG 02 and length 02 








Select a TLV (tag 02h) 








f indAndCompareValue () 
tag = ODh 
occurrence = 2 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




14 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




15 


Verify current TLV 

getValueLength ( ) 


Result is 17 




16 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Initialize compareBuffer 

compareBuff er = 
00 11 22 33 44 55 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




23 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueO 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




24 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuffer . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




25 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuff er . length = 16 
compareOf f set = 
compareLength = 16 


Result is OOh 




26 


Successful call, findAndCompareValue with 
length =0 

CompareBuff er . length = 16 
compareOf f set =16 
compareLength = 


Result of findAndCompareValue 
is 00 





6.2.5.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18,22,21,26 


N4 


16, 19,23 


N5 


17, 19 


N6 


25,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


P4 


11 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.5.15 Method appendArray 

Test Area Reference: API_2_ERH_APDA_BSS 
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6.2.5.15.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, short offset, short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.5.15.1.1 Normal execution 

• CRRN 1 : appends a buffer into the EditHandler buffer 

• CRRN2; a successful append does not modify the TLV selected 

6.2.5.15.1.2 Parameters error 

• CRRPl: if buffer is null, a java.lang.NuUPointerException is thrown 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 



6.2.5.15.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.15.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_APDA_BSS_l.scr 

Test Applet: API_2_ERH_APDA_BSS_l.java 

Load Script: API_2_ERH_APDA_BSS_l.ldr 

Cleanup Script: API_2_ERH_APDA_BSS_l.cb- 

Parameter File: API_2_ERH_APDA_BSS_1 .par 



6.2.5.15.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 








TLV of length 1 






1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 


ArraylndexOutOfBoundsExceptio 






buf fer . length = 5 


n is thrown 






offset = 5 








length = 1 






3 


offset < 


ArraylndexOutOfBoundsExceptio 






buffer.length = 5 


n is thrown 






offset = -1 








length = 1 






4 


length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer.length = 5 


n is thrown 






offset = 








length = 6 






5 


offset + length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer.length = 5 


n is thrown 






offset = 3 








length = 3 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


length < 

buf fer . length = 5 
offset = 
length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Handler overflow 

buf fer . length = 256 
offset = 
length = 256 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








flndTLV 0x81 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare handler 

compareBuf fer = FF FE ... F8 


Result is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copvO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare handler 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result is OOh 





6.2.5.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


N3 




P1 


1 


P2 


2,3,4,5,6 


C1 


7 


C2 


Does not apply for EnvelopeResponseHandler 



6.2.5.1 6 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_ERH_APTLBB 

6.2.5.16.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 
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6.2.5.16.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.1 6.1 .2 Parameters error 
No requirements 

6.2.5.16.1.3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.16.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.16.3 



API_2_ERH_APTLBB_l.scr 
API_2_ERH_APTLBB_1 .Java 
API_2_ERH_APTLBB_1 .Idr 
API_2_ERH_APTLBB_1 .clr 
API_2_ERH_APTLBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 253 








Handler Overflow: Call twice the 
appendTLV()method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown by one of the 
two. 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare handler 

compareBuf fer = 84 01 00 


Result is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare handler 

compareBuffer = 84 01 00 01 01 FE 


Result is OOh 




NOTE: Test case 1 call twice appendTLV because the current 3GPP TS 43.019 [7] is not clear enough on this point. 
So this test allows the two possible implementations. 
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6.2.5.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


CI 


1 


C2 


Does not apply for EnvelopeResponseHandler 



6.2.5.1 7 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_ERH_APTLBBB 

6.2.5.17.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 

6.2.5.17.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 



6.2.5.17.1.2 
No requirements 

6.2.5.17.1.3 



Parameters error 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.17.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.17.3 



API_2_ERH_APTLBBB_1 .scr 
API_2_ERH_APTL BBB_l.java 
API_2_ERH_APTL BBB_l.ldr 
API_2_ERH_APTLBBB_1 .clr 
API_2_ERH_APTLBBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArray with length of 253 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 


Result is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare handler 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result is OOh 





6.2.5.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


CI 


1 


C2 


Does not apply for EnvelopeResponseHandler 



6.2.5.18 



Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 



Test Area Reference: API_2_ERH_APTLB_BSS 

6.2.5.18.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.5.18.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.18.1.2 Parameters error 

• CRRPl: if value is null, a java.lang. NullPointerException is thrown 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang. ArraylndexOutOfBoundsException is thrown. 
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6.2.5.18.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 

6.2.5.18.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: API_2_ERH_APTLB_BSS_l.scr 

Test Applet: API_2_ERH_APTLB_BSS_l.java 

Load Script: API_2_ERH_APTLB_BSS_l.ldr 

Cleanup Script: API_2_ERH_APTLB_BSS_l.clr 

Parameter File: API_2_ERH_APTLB_BSS_l.par 



6.2.5.18.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value . length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value . length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 
valueLength = 254 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Clear the handler 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Call copyO method 








Compare handler 

CompareBuf fer = 04 08 FF FE ... F8 


Result is 00 




11 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 








Call copyO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result is 00 




12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copyO method 








Compare handler 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 








Call copvO method 








Compare handler 

compareBuffer = 04 81 80 00 01. ..7F 


Result is 00 





6.2.5.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for EnvelopeResponseHandler 


C3 


8 



6.2.5.1 9 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 



Test Area Reference: API_2_ERH_APTLBB_BSS 



6.2.5.19.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 
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6.2.5.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.1 9.1 .2 Parameters error 

• CRRPl: if value2 is null, a java.lang.NuUPointerException is thrown 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



6.2.5.19.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a TooMtException is thrown with 
reason code HANDLER_OVERFLOW 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER 

6.2.5.19.2 Test suite files 
Specific triggering: Unrecognized Envelope 

Test Script: APl_2_ERH_APTLBB_BSS_l.scr 

Test Applet: API_2_ERH_APTLBB_BSS_l.java 

Load Script: API_2_ERH_APTLBB_BSS_l.ldr 

Cleanup Script: API_2_ERH_APTLBB_BSS_l.clr 

Parameter File: API_2_ERH_APTLBB_BSS_l.par 



6.2.5.19.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 


ArraylndexOutOfBoundsExceptio 






value2 . length = 5 


n is thrown 






value20ffset = 5 








value2Length = 1 






3 


value20ffset < 


ArraylndexOutOfBoundsExceptio 






value2 . length = 5 


n is thrown 






value20ffset = -1 








value2Length = 1 






4 


value2Length > value2.length 


ArraylndexOutOfBoundsExceptio 






value2 . length = 5 


n is thrown 






value20ffset = 








value2Length = 6 






5 


value20ffset + value2Length > value2.length 


ArraylndexOutOfBoundsExceptio 






value2 . length = 5 


n is thrown 






value20ffset = 3 








value2Length = 3 






6 


value2Length < 


ArraylndexOutOfBoundsExceptio 






value2 . length = 5 


n is thrown 






value20ffset = 








value2Length = -1 






7 


Handler overflow 


Tooll<itException. HANDLER OVE 






value2 . length = 254 


RFLOW is thrown 






value20ffset = 








value2Length = 254 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Bad parameter 

value2 . length = 256 
value20ffset = 
value2Length = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 




9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03ii 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare handler 

CompareBuffer = 04 09 05 FF FE ... F8 


Result is 00 




11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copvO method 








Compare handler 

CompareBuffer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result is 00 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare handler 

CompareBuffer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result is 00 




13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copvO method 








Compare handler 

CompareBuffer = 04 81 80 00 01. ..7F 


Result is 00 
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6.2.5.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for EnvelopeResponseHandler 


C3 


8 



6.2.5.20 Method clear 

Test Area Reference: API_2_ERH_CLER 

6.2.5.20.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void clear ( ) 

throws ToolkitException 

6.2.5.20.1.1 Normal execution 

• CRRNl: Clears the TLV list of an EditHandler and resets the current TLV selected. 



6.2.5.20.1.2 
No requirements 

6.2.5.20.1.3 



Parameters error 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE 

6.2.5.20.2 Test suite files 

Specific triggering: Unrecognized Envelope 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.20.3 



API_2_ERH_CLER_1 .scr 
API_2_ERH_CLER_1 .Java 
API_2_ERH_CLER_1 .Idr 
API_2_ERH_CLER_1 .ck 
API_2_ERH_CLER_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO Is 




2 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT Is thrown 
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6.2.5.20.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.6 Class MEProfile 

6.2.6.1 Method check (byte index) 

Test Area Reference: API_2_MEP_CHECB 

6.2.6.1.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 
throws ToolkitException 

6.2.6.1 .1 .1 Normal execution 

• CRRNl: The method checks a facility in the handset profile: returns true if supported and false otherwise. 

6.2.6.1.1.2 Parameters error 
No requirements. 

6.2.6.1.1.3 Context errors 

• CRRC 1 : The method shall throw ME_PROFILE_NOT_A VAIL ABLE ToolkitException if Terminal Profile data 
are not available 

6.2.6.1.2 Test suite files 
Specific triggering: 

EVENT_STATUS_COMMAND 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.1.3 



AP1_2_MEP_CHECB_1 .scr 
AP1_2_MEP_CHECB_1 .Java 
AP1_2_MEP_CHECB_1 .Idr 
AP1_2_MEP_CHECB_1 .ck 
AP1_2_MEP_CHECB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

index = 15 


false is returned by the method 
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6.2.6.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 



6.2.6.2 Method check (byte [ ] mask, short offset, short length) 

Test Area Reference: API 2 MEP CHEC BSS 



6.2.6.2.1 



Conformance requirement: 



The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws Java. lang.NullPointerException, 

Java. lang. Array IndexOutOfBoundsExcept ion. 
Toolkit Except ion 



6.2.6.2.1.1 



Normal execution 



• CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if 
they are all supported and false if not. 

• CRRN2: The method returns true if the length to check is 0. 

6.2.6.2.1 .2 Parameters error 

• CRRPl: The method shall throw Java. lang.NullPointerException if mask is null. 

• CRRP2: The method shall throw Java. lang. ArraylndexOutOfBoundsException if offset or length or both would 
cause access outside array bounds. 

• CRRP3: The method shall throw ME_PROFILE_NOT_AVAILABLE ToolkitException if Terminal Profile data 
are not available. 

6.2.6.2.1.3 Context errors 
No requirements. 

6.2.6.2.2 Test suite files 

Specific triggering: 

UNFORMATTED_SMS_PP_UPD 
No Additional requirements for the GSM personalization: 

Test Script: API_2_MEP_CHEC_BSS_l.scr 

Test Applet: API_2_MEP_CHEC_BSS_l.java 

Load Script: API_2_MEP_CHEC_BSS_1 .Idr (the applet is loaded without INI after the reset (RST)) 

Cleanup Script: API_2_MEP_CHEC_BSS_l.ck 

Parameter File: API_2_MEP_CHEC_BSS_1 .par 
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6.2.6.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 


No Terminal Profile is registered 

Triggered by unformatted SMS 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 

Offset = 

Length = 16 


ME_PROFILE_NOT_AVAIL 
ABLE ToolkitException is 
thrown 




2 


NULL as parameter to check 

mask= NULL 


NullPointerException is 
thrown 




3 


Offset > mask.length 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 17 


Array IndexOutOfBoundsExc 
option is thrown 




4 


Offset < 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = -1 


ArraylndexOutOfBoundsExc 
eption is thrown 




5 


Length > mask.length 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length =18 


ArraylndexOutOfBoundsExc 
eption is thrown 




6 


Offset + length > mask.length 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 9 
Length = 9 


ArraylndexOutOfBoundsExc 
eption is thrown 




7 


length = 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length = 


true is returned 




8 


Check all the Terminal Profile 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 
Length =16 


false is returned by the 
method because facility 15 is 
not supported 




9 


Check a part of the Terminal Profile 

mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
Offset = 15 
Length = 2 


true is returned by the 
method: the 16 first facilities 
except facility 15 have been 
successfully checked 




10 


Check a part of the Terminal Profile 

mask = 0x0080 
Offset = 
Length = 2 


false is returned by the 
method only facility 15 is 
checked and not supported. 





6.2.6.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10 


N2 


7 


PI 


2 


P2 


3, 4, 5, 6 


P3 


1 



6.2.6.3 Method check (short index) 

Test Area Reference: API_2_MEP_CHECS 

6.2.6.3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (short index) 
throws ToolkitException 



6.2.6.3.1.1 



Normal execution 



CRRNl: The method checks a facility in the handset profile: returns true if the facility is supported, false if 
facility is not supported, or if facility -index outside MEProfile data. 
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6.2.6.3.1.2 

No requirements. 

6.2.6.3.1.3 



Parameters error 



Context errors 



CRRCl: The method shall throw ME_PROFILE_NOT_AV AIL ABLE ToolkitException if Terminal Profile data 
are not available 



Test suite files 



6.2.6.3.2 
Specific triggering: 

EVENT_STATUS_COMMAND 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.3.3 



API_2_MEP_CHECS_1 .scr 
API_2_MEP_CHECS_1 .Java 
API_2_MEP_CHECS_1 .Idr 
API_2_MEP_CHECS_1 .ck 
API_2_MEP_CHECS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

index = 15 


false is returned by the method 




4 


Facility index is outside MEProfile data 

index = 0x0099 


false is returned by the method 





6.2.6.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4 


C1 


1 



6.2.6.4 Method getValue (short indexMSB, short indexLSB) 

Test Area Reference: API_2_MEP_GVALSS 

6.2.6.4.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static short getValue (short indexMSB, short indexLSB) 
throws ToolkitException 

6.2.6.4.1.1 Normal execution 

• CRRNl: The method returns the binary value of a parameter, delimited by two indexes, from the handset profile. 
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6.2.6.4.1.2 



Parameters error 



• CRRP 1 : The method shall throw B AD_INPUT_PARAMETER ToolkitException if (indexMSB indexLSB 
+16) or (indexMSB < indexLSB) or (indexMSB < 0) or (indexLSB < 0). 



6.2.6.4.1.3 



Context errors 



• CRRC 1 : The method shall throw ME_PROFILE_NOT_AVAILABLE ToolkitException if Terminal Profile data 
are not available. 

6.2.6.4.2 Test suite files 

Specific triggering: 

EVENT_STATUS_COMMAND 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.4.3 



API_2_MEP_GVALSS_Lscr 
API_2_MEP_GVALSS_1 .Java 
API_2_MEP_GVALSS_1 .Idr 
API_2_MEP_GVALSS_1 .clr 
API_2_MEP_GV ALSS_1 .par 

Test procedure 



TP = FF 01 D2 FO 00 00 00 00 00 00 00 00 00 8D FF 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
indexMSB = 15, indexLSB = 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Retrieve number of character down ME display 
In Terminal Profile which is 13 

indexMSB = 108, indexLSB = 104 


13 is returned by the method 




3 


Retrieve byte 3 and byte 4 from terminal 
profile. 

Byte 3 = 0xD2, Byte 4 = OxFO 
indexMSB = 31, indexLSB =16 


0xF0D2 is returned by the method 




4 


IndexMSB Is negative 

indexMSB = OxFFFF, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




5 


IndexLSB Is negative 

indexMSB = 0x0002, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




6 


IndexMSB < indexLSB 

indexMSB = 0x0002, indexLSB = 0x0003 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




7 


IndexMSB > IndexLSB + 16 

indexMSB = 0x0021, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 





6.2.6.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3 


PI 


4, 5, 6, 7 


CI 


1 



6.2.6.5 



Method copy (short startOffset, byte[] dstBuffer, short dstOffset, short 
dstLength) 



Test Area Reference: API 2 MEP COPYS BSS 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



134 



ETSI TS 151 013 V4.1.0 (2003-12) 



6.2.6.5.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static short copy (short startOffset, byte[] dstBuffer, short dstOffset, short dstLength) 
throws ToolkitException 

6.2.6.5.1.1 Normal execution 

• CRRNl : The method copies a part of the handset profile in a buffer. 

• CRRN2; The method returns dstOffset + dstLength. 

6.2.6.5.1.2 Parameters error 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2 : //'dstOffset or dstLength parameter is negative an 
ArraylndexOutOfBoundsException exception is thrown and no copy is performed 

• CRRP3: T/'dstOf f set+dstLength is greater than dstBuffer . length, the length of the dstBuffer 
array an ArraylndexOutOfBoundsException exception is thrown andno copy is performed 



6.2.6.5.1.3 



Context errors 



CRRCl: The method shall throw ME_PROFlLE_NOT_AVAlLABLE ToolkitException if Terminal Profile data 
are not available. 



Test suite files 



6.2.6.5.2 
Specific triggering: 

EVENT_STATUS_COMMAND 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.5.3 



APl_2_MEP_COPYS_BSS_l .scr 
APl_2_MEP_COPYS_BSS_l .Java 
AP1_2_MEP_C0PYS_BSS_1 .Idr 
AP1_2_MEP_C0PYS_BSS_1 .clr 
APl_2_MEP_COPYS_BSS_l .par 

Test procedure 



TP = FF 01 D2 FO 01 02 00 00 00 00 00 00 00 8D FF 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
StartOffset = 
dstBuffer.length = 6 
dstOffset = 
dstLength = 5 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


dstBuffer is null 


NullPointerException is thrown 




3 


dstOffset > dstBuffer.length 

StartOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException 
Is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstOffset < 

StartOffset = 
dstBuffer . length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException 
is thrown 




5 


dstLength < 

StartOffset = 
dstBuffer . length = 5 
dstOffset = 1 
dstLength = -1 


ArraylndexOutOfBoundsException 
is thrown 




6 


dstLength >dstBuffer.length 

StartOffset = 
dstBuffer . length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException 
Is thrown 




7 


dstOffset + dstLength >dstBuffer.length 

StartOffset = 
dstBuffer . length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsException 
is thrown 




8 


Successful call extreme values 

StartOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 




9 


Successful call any values 

StartOffset = 1 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyO is 7 




10 


Successful call, copy with length =0 

StartOffset = 
dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyO is 20 




11 


Value outside MEProfile data available 

StartOffset = 13 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 





6.2.6.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11 


N3 


8,9, 10, 11 


P1 


2 


P2 


4,5 


P3 


3,6,7 


C1 


1 



6.2.7 Class ProactiveHandler 
6.2.7.1 Method getTheHandler 

Test Area Reference: API_2_PAH_GTHD 

6.2.7.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandler ( ) 

throws ToolkitException 
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6.2.7.1 .1 .1 Normal execution 

• CRRNl: The method shall return the single system instance of the ProactiveHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

6.2.7.1.1.2 Parameter errors 
No requirements. 

6.2.7.1.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 

6.2.7.1.2 Test Suite files 

Test Script: API_2_PAH_GTHD_1 . scr 

API_2_PAH_GTHD_1 .j ava 

API_2_PAH_GTHD_1 .Idr 

API_2_PAH_GTHD_1 .clr 

API_2_PAH_GTHD_1 .par 

Test procedure 



Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.1.3 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandlerO 


The reference shall be a 
ProactiveHandler 




3 


getTheHandlerO 


The reference shall not be null 





6.2.7.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in Framework tests and insert here cross reference 


CI 


To be checked in Framework tests and insert here cross reference 



6.2.7.2 Method init 

Test Area Reference: API_2_PAH_INITBBB 

6.2.7.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 



6.2.7.2.1.1 



Normal execution 



• CRRNl: The init() method initializes the next Proactive command in the ProactiveHandler, with Command 
details and Device Identities TLV. The source device is always the SIM Card (81h). The Comprehension 
Required flags are set. 
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• CRRN2: The Command number may take any value between Olh and FEh. 

• CRRN3: The init() method clears the ProactiveHandler before initializing it. 

• CRRN4: No TLV is selected after a call to the method. 

• CRRN5: The handler is not sent to the mobile by the init() method. 



6.2.7.2.1.2 

No requirements. 

6.2.7.2.1.3 

No requirements. 

6.2.7.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.2.3 



Parameter errors 

Context errors 

Test Suite files 

API_2_PAH_INITBBB_1 .scr 
API_2_PAH_INITBBB_1 .j ava 
API_2_PAH_INITBBB_1 .Idr 
API_2_PAH_INITBBB_1 .clr 
API_2_PAH_INITBBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are identical 




2 


Verify the command number value 


Olh-FEh 




3 


Call the initO method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactiveHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getValueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is tlirown by 
getValueLengtliO 
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6.2.7.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



6.2.7.3 Method initDisplayText 

Test Area Reference: API_2_PAH_INDTBB_BSS 

6.2.7.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initDisplayText (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



6.2.7.3.1.1 



Normal execution 



• CRRNl: The method shall build a DISPLAY TEXT proactive command in the ProactiveHandler, using 
qualifier, dcs and buffer parameters. Comprehension required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3: No TLV is selected after a call to the method. 

• CRRN4: The DISPLAY TEXT command is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

6.2.7.3.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, an 
ArraylndexOutOfBoundsException shall be thrown. 



6.2.7.3.1.3 



Context errors 



• CRRCl : A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is too small to 
put the requested data. 



6.2.7.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PAH_INDTBB_BSS_1 .scr 
API_2_PAH_INDTBB_BSS_1 .Java 
API_2_PAH_INDTBB_BSS_1 .Idr 
API_2_PAH_INDTBB_BSS_1 .clr 
API_2_PAH_INDTBB_BSS_1 .par 
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6.2.7.3.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 5 








length = 






3 


offset < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = -1 






4 


length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 








length = 5 






5 


Offset + length > buffer.length 


Array 1 ndexOutOfBou ndsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the end part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextB" 




Text = "TextB" 




offset = 2 








length = 5 






10 


Successful call, buffer is part of a buffer with 




DISPLAY TEXT Proactive 




the first part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "TextC12" 




Text = "TextC" 




offset = 








length = 5 






11 


Successful call, buffer is part of a buffer 




DISPLAY TEXT Proactive 




Send the command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "12TextD34" 




dcs = 4 




offset = 2 




Text = "TextD" 




length = 5 






12 


Successful call, qualifier = 81h 




DISPLAY TEXT Proactive 




Send the command 




command 




qualifier = 81h 








dcs = 4 




qualifier = 81h 




buffer = "TextE" 




dcs = 4 




offset = 




Text = "TextE" 




length = 5 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 
Send the command 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 

Text = "TextF" 


14 


Successful call, DCS=8 (UCS2) 
Send the command 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 8 

Text = "TextG" 


15 


Call the InitDisplayTextO method with any 

value 

Then build and send a DISPLAY TEXT 

command 

qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 10 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 

dcs = 4 

buffer = "" (not null buffer) 

offset = 

length = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the InitDisplayTextO method 
Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




DISPLAY TEXT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the InitDisplayTextO method with a too 
long buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitDisplayTextO without sending the 
command 




No proactive command shall 
be sent expected status is 
'9000' 
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6.2.7.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2,3,4,5,6 


C1 


21 



6.2.7.4 Method initGetlnkey 

Test Area Reference: API_2_PAH_INGKBB_BSS 



6.2.7.4.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public void initGetlnkey (byte qualifier^ 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



6.2.7.4.1.1 



Normal execution 



• CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using qualifier, dcs 
and buffer parameters. Comprehension Required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3: No TLV is selected after a call to the method. 

• CRRN4: The GET INKEY command is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

6.2.7.4.1 .2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRPl : If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 



6.2.7.4.1.3 



Context errors 



CRRCl: A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 



6.2.7.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_INGKBB_BSS_1 .scr 
API_2_PAH_INGKBB_BSS_1 .Java 
API_2_PAH_INGKBB_BSS_1 .Idr 
API_2_PAH_INGKBB_BSS_1 .clr 
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Parameter File: 



API_2_PAH_INGKBB_BSS_1 .par 



6.2.7.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 


Array 1 ndexOutOfBou ndsExceptio 
n is tlirown 




3 


offset < 

buffer = "Text" 
offset = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 
the end part 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextB" 


10 


Successful call, buffer is part of a buffer with 
the first part 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextC" 


11 


Successful call, buffer is part of a buffer 
Send the command 

qualifier = 

dcs = 4 

buffer = "12TextD34" 

offset = 2 

length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 4 

Text = "TextD" 


12 


Successful call, qualifier = 81h 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = 81h 

dcs = 4 

Text = "TextE" 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 

Text = "TextF" 


14 


Successful call, DCS=8 (UCS2) 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 

dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkeyO method with any value 
Then build and send a GET INKEY command 




GET INKEY Proactive 
command 




qualifier = 

dcs = 4 

buffer = "TextHTextH" 

offset = 

length = 10 




qualifier = OOh 

dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 




GET INKEY Proactive 
command 




qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 




qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 

Call the initGetlnkeyO method 

Call the getValueLengthO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 




GET INKEY Proactive 
command 




dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 




GET INKEY Proactive 
command 




dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 




GET INKEY Proactive 
command 




dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the InitGetlnkeyO method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitGetlnkeyO without sending the 
command 




No proactive command shall 
be sent expected status is 
'9000' 
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6.2.7.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2,3,4,5,6 


C1 


21 



6.2.7.5 Method initGetlnput 

Test Area Reference: API_2_PAH_INGPBB_BSSSS 

6.2.7.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void initGetlnput (byte qualifier^ 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws Java . lang. NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 



6.2.7.5.1.1 



Normal execution 



• CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, 
dcs, buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3: No TLV is selected after a call to the method. 

• CRRN4: The GET INPUT command is not sent by the method. 

• CRRN5; The Command Number may take any value between Olh and FEh. 

6.2.7.5.1.2 Parameter errors 

• CRRPl: The method shall throw NullPointerException if buffer is null. 

• CRRP2: If offset or length or both would cause access outside array bounds, a 
ArraylndexOutOfBoundsException shall be thrown. 



6.2.7.5.1.3 



Context errors 



• CRRCl : A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 

6.2.7.5.2 Test Suite files 

Test Script: API_2_PAH_INGPBB_BSSSS_Lscr 

Test Applet: API_2_PAH_INGPBB_BSSSS_Ljava 

Load Script: API_2_PAH_INGPBB_BSSSS_Lldr 
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Cleanup Script: 
Parameter File: 

6.2.7.5.3 



API_2_PAH_INGPBB_BSSSS_1 .clr 
API_2_PAH_INGPBB_BSSSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


Offset > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 5 






3 


Offset < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = -1 






4 


length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 








length = 5 






5 


Offset + length > buffer.length 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = 2 






6 


length < 


ArraylndexOutOfBoundsExceptio 






buffer = "Text" 


n is thrown 






offset = 3 








length = -1 






7 


Successful call, buffer is the whole buffer 

qualifier = 

dcs = 4 

buffer = "TextA" 

offset = 

length = 5 

minRespLength = OOh 

maxRespLength = FFh 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and -FEh 




8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 
Min Length = OOh 
Max Length = FFh 


9 


Successful call, buffer is part of a buffer with 




GET INPUT Proactive 




the end part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "12TextB" 




Text = "TextB" 




offset = 2 




Min Length = lOh 




length = 5 




Max Length = FFh 




minRespLength = lOh 








maxRespLength = FFh 






10 


Successful call, buffer is part of a buffer with 




GET INPUT Proactive 




the first part 




command 




Send the command 








qualifier = 




qualifier = OOh 




dcs = 4 




dcs = 4 




buffer = "TextC12" 




Text = "TextC" 




offset = 




Min Length = FFh 




length = 5 




Max Length = FFh 




minRespLength = FFh 








maxRespLength = FFh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call, buffer is part of a buffer 




GETINPUT Proactive 




Send the command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "12TextD34" 




dcs = 4 




offset = 2 




Text = "TextD" 




length = 5 




Min Length = OOh 




minRespLength = OOh 




Max Length = OOh 




maxRespLength = OOh 






12 


Successful call, qualifier = 81h 




GET INPUT Proactive 




qualifier = 81h 




command 




dcs = 4 








buffer = "TextE" 




qualifier = 81h 




offset = 




dcs = 4 




length = 5 




Text = "TextE" 




minRespLength = OOh 




Min Length = OOh 




maxRespLength = lOh 




Max Length = lOh 


13 


Successful call, DCS=0 (7 bits) 




GET INPUT Proactive 




qualifier = 




command 




dcs = 








buffer = "TextF" 




qualifier = OOh 




offset = 




dcs = 




length = 5 




Text = "TextF" 




minRespLength = lOh 




Min Length = lOh 




maxRespLength = lOh 




Max Length = lOh 


14 


Successful call, DCS=8 (UCS2) 




GET INPUT Proactive 




qualifier = 




command 




dcs = 8 








buffer = "TextG" 




qualifier = OOh 




offset = 




dcs = 8 




length = 5 




Text = "TextG" 




minRespLength = OOh 




Min Length = OOh 




maxRespLength = FFh 




Max Length = FFh 


15 


Call the InitGetlnputO method with any value 




GET INPUT Proactive 




Then build and send a GET INPUT command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "TextHTextH" 




dcs = 4 




offset = 




Text = "TextHTextH" 




length = 10 




Min Length = OOh 




minRespLength = OOh 




Max Length = lOh 




maxRespLength = lOh 






16 


Successful call, text length is null 




GET INPUT Proactive 




Send the command 




command 




qualifier = 








dcs = 4 




qualifier = OOh 




buffer = "" 




Text String TLV = 8D 00 




offset = 




Min Length = OOh 




length = 




Max Length = lOh 




minRespLength = OOh 








maxRespLength = lOh 






17 


Select a TLV in the ProactiveHandler 


UNAVAILABLE_ELEMENT 






Call the InitGetlnputO method 


ToolkitException is thrown by 






Call the getValueLengthO method 


getValueLengthO 




18 


Successful call, buffer length = 7Eh 

qualifier = 




GET INPUT Proactive 
command 




dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 7F 04 55 55... 




offset = 




Min Length = OOh 




length = 7Eh 




Max Length = lOh 




minRespLength = OOh 








maxRespLength = lOh 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Successful call, buffer length = 7Fh 

qualifier = 




GET INPUT Proactive 
command 




dcs = 4 




Text String TLV = 8D 81 




buffer = "UUU..." 




80 04 55 55... 




offset = 




Min Length = OOh 




length = 7Fh 




Max Length = lOh 




minRespLength = OOh 








maxRespLength = lOh 






20 


Successful call, buffer length = 236 

Qualifier = 




GET INPUT Proactive 
command 




dcs = 4 




Text String TLV = 




buffer = "UUU..." 




8D 81 ED 04 55 55... 




offset = 








length = 236 








minRespLength = OOh 








maxRespLength = lOh 






21 


Call the initGetlnputO method with a too long 


HANDLER OVERFLOW 






buffer 


ToolkitException is thrown 






qualifier = 








dcs = 4 








buffer = "XXXX..." 








offset = 








length = 237 








minRespLength = OOh 








maxRespLength = lOh 






22 


Call the InitGetlnputO without sending the 




No proactive command shall 




command 




be sent expected status is 
'9000' 



6.2.7.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


8,9, 10, 11, 12, 13, 14, 15, 16, 18, 19,20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


PI 


1 


P2 


2,3,4,5,6 


CI 


21 



6.2.7.6 Method send 

Test Area Reference: API_2_PAH_SEND 

6.2.7.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte send() 

6.2.7.6.1.1 Normal execution 

• CRRNl: The send() method send the current proactive command to the mobile. 

• CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

• CRRN3: The handler remains unchanged after a call to send() method until the use of inifXX() or appendTLV(). 

• CRRN4: There is no invocation of select() or deselect() method. 

• CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 
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6.2.7.6.1.2 

No requirements. 

6.2.7.6.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is the Result Simple TLV is 
missing in Terminal Response. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Simple TLV in Terminal Response. 



6.2.7.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.6.3 



Test Suite files 

API_2_PAH_SEND_1 .scr 
API_2_PAH_SEND_1 .Java 
API_2_PAH_SEND_1 .Idr 
API_2_PAH_SEND_1 .clr 
API_2_PAH_SEND_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = 00 

Result TLV = 03 01 00 (command performed 
successfully) 


Result of send{) is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional information on result 

Result TLV = 03 01 01 (command performed 
with partial comprehension) 


Result of send() is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 


Result of send{) is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendO is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Build and send a 80h byte command (DISPLAY 
TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 80 
Text String TLV = 8D 75 

04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 
Fl 04 55 55... 


12 


Verify that the Proactive Handler is not 

modified after a send() 

Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 

Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 

Verify there is no invocation of select() or 

deselectO method. 




DISPLAY TEXT Proactive 
command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 


Result of sendO is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by send() 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result byte 
in the Simple TLV 

Result TLV = 03 00 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown by 
send() 





6.2.7.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3,5,7,9, 10, 11, 12, 13, 14 


N2 


2,4,6,8, 14 


N3 


12 


N4 


13 


N5 


To be checked in Framework tests and insert here cross reference 


C1 


15 


C2 


16 



6.2.7.7 Method getLength 

Test Area Reference API_2_PAH_GLEN 
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6.2.7.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength() 

throws ToolkitException 

6.2.7.7.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.7.7.1 .2 Parameter errors 
No requirements. 

6.2.7.7.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



6.2.7.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.7.3 



Test Suite files 

API_2_PAH_GLEN_1 .scr 
API_2_PAH_GLEN_1 .Java 
API_2_PAH_GLEN_1 .Idr 
API_2_PAH_GLEN_1 .clr 
API_2_PAH_GLEN_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength () 


Result of getLengthO is 




2 


Call the initO method 

getLength () 


Result of getLengthO is 9 




3 


Call the InitDlsplayTextO method, with buffer 
length = 240 

getLength ( ) 


Result of getLengthO is 253 




4 


Build a 7Fh Proactive Handler 

getLength () 


Result of getLengthO is 7Fh 




5 


Build a 80h Proactive Handler 

getLength () 


Result of getLengthO is 80h 





6.2.7.7.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


C1 


Does not apply for Proactive Handler 



6.2.7.8 Method copy 

Test Area Reference API_2_PAH_COPY_BSS 
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6.2.7.8.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuff er, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.8.1.1 Normal execution 

• CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.7.8.1.2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 



6.2.7.8.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.8.3 



Test Suite files 

API_2_PAH_COPY_BSS_l.scr 
API_2_PAH_COP Y_BSS_1 .Java 
API_2_PAH_COPY_BSS_l .Idr 
API_2_PAH_COPY_BSS_l .clr 
API_2_PAH_COPY_BSS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the initO method 








DstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 6 
dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


dstLength < 

dstBuffer . length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer .length = 10 
dstOffset = 
dstLength = 10 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer. length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer .length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer .length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





6.2.7.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for ProactiveHandler 



6.2.7.9 Method findTLV 

Test Area Reference API_2_PAH_FINDBB 

6.2.7.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.7.9.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 

is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 
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6.2.7.9.1.2 



Parameter errors 



• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 



6.2.7.9.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.9.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.9.3 



Test Suite files 

API_2_PAH_FINDBB_l.scr 
API_2_PAH_FINDBB_1 .Java 
API_2_PAH_FINDBB_1 .Idr 
API_2_PAH_FINDBB_1 .ck 
API_2_PAH_FINDBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








Invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 




2 


Call the initO method 








Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 
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6.2.7.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2,4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for Proactive Handler 



6.2.7.10 Method getValueLength 

Test Area Reference API_2_PAH_GVLE 

6.2.7.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 



6.2.7.10.1.1 



Normal execution 



• CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



6.2.7.10.1.2 
No requirements. 

6.2.7.10.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.10.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.10.3 



Test Suite files 

API_2_PAH_GVLE_1 .scr 
API_2_PAH_GVLE_1 .Java 
API_2_PAH_GVLE_1 .Idr 
API_2_PAH_GVLE_1 .clr 
API_2_PAH_GVLE_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initO method 








getValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Call the appendTLVO method 

tag = OD 
valueOffset = 
valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Call the InltDlsplayTextQ method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Call the InitDisplayTextO method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Call the InitDisplayTextO method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Call the InitDisplayTextO method 

length = FOh (maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is F1h 





6.2.7.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4,5,6 


C1 


Does not apply for Proactive Handler 


C2 


1 



6.2.7.1 1 Method getValueByte 

Test Area Reference API_2_PAH_GVBYS 

6.2.7.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



6.2.7.11.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 

byte). 



6.2.7.11.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.7.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 
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6.2.7.11.2 


Test Suite files 




Test Script: 


API_2_PAH_GVBYS_ 


_l.scr 


Test Applet: 


API_2_PAH_GVBYS_ 


_l.java 


Load Script: 


API_2_PAH_GVBYS_ 


_l.ldr 


Cleanup Script: 


API_2_PAH_GVBYS_ 


_l.clr 


Parameter File: 


API_2_PAH_GVBYS_ 


_l.par 


6.2.7.11.3 


Test procedure 





Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 

type = FFh 
qualifier = FEh 
destination = FDh 








getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte(3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 81 h (Source) 




5 


initDisplayTextQ 

buffer = 00 01 ... 7D 

length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


initDisplayTextO 

buffer = 00 01 ... 7D 7E 

length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




7 


getValueByte(7F) 


Result is 7Eh 




8 


initDisplayTextO 

buffer = 00 01 ... EF 

length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





6.2.7.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


CI 


Does not apply for Proactive Handler 


C2 


1 



6.2.7.12 Method copyValue 

Test Area Reference API_2_PAH_CPYVS_BSS 
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6.2.7.12.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuff er, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.12.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.7.12.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.7.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.12.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.12.3 



Test Suite files 

API_2_PAH_CPYVS_BSS_1 .scr 
API_2_PAH_CPYVS_BSS_1 .Java 
API_2_PAH_CPYVS_BSS_1 .Idr 
API_2_PAH_CPYVS_BSS_1 .clr 
API_2_PAH_CPYVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








copyValue with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.length 

dstBuffer .length = 5 
dstOffset = 6 
dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstLength >dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer .length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


InltDlsplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
dstBuffer. length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
dstBuffer. length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
valueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + dstLength > Text String 

length 

valueOffset = 2 

dstBuffer. length = 15 

dstOffset = 

dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








copyValueO 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




12 


InltDlsplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Successful call 

valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuffer .length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 
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CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 



6.2.7.13 Method compareValue 

Test Area Reference API 2 PAH CPRVS BSS 



6.2.7.13.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang. NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

6.2.7.13.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.7.13.1.2 Parameter errors 

• CRRP 1 : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.7.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.13.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Test Suite files 

API_2_PAH_CPRVS_BSS_1 .scr 
API_2_PAH_CPRVS_BSS_1 .Java 
API_2_PAH_CPRVS_BSS_1 .Idr 
API_2_PAH_CPRVS_BSS_1 .clr 
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Parameter File: 



API_2_PAH_CPRVS_BSS_1 .par 



6.2.7.13.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareBuffer . length = 5 
compareOffset = 6 
compareLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextO with length = 5 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 

length 

valueOffset = 2 

compareBuffer.length = 15 

compareOffset = 

compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareValueO 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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6.2.7.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13,16 


N3 


14, 17, 18 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 



6.2.7.14 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference API_2_PAH_FACYB_BS 

6.2.7.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
Toolkit Except ion 



6.2.7.14.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.7.14.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.7.14.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.7.14.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PAH_FACYB_BS_1 .scr 
API_2_PAH_FACYB_BS_1 .Java 
API_2_PAH_FACYB_BS_1 .Idr 
API_2_PAH_FACYB_BS_1 .clr 
API_2_PAH_FACYB_BS_1 .par 
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6.2.7.14.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer.length 

DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








append a 2nd Text String TLV 








Successful call 

tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

dstBuffer. length = 16 

dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for Proactive Handler 



6.2.7.15 



Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 



Test Area Reference API 2 PAH FACYBBS BSS 



6.2.7.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 



6.2.7.15.1.1 



Normal execution 



• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.7.15.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 
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6.2.7.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.7.15.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.15.3 



Test Suite files 

API_2_PAH_FACYBBS_BSS_1 .scr 
API_2_PAH_FACYBBS_BSS_1 .Java 
API_2_PAH_FACYBBS_BSS_1 .Idr 
API_2_PAH_FACYBBS_BSS_1 .clr 
API_2_PAH_FACYBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


JnitDisplayTextO with length = 15 








dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplaylextQ with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown. 




12 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer. length = 20 
dstOffset = 3 
dstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = 00 11 22 33 44 55 (no specific 

DCS byte) 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




17 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer .length = 17 
dstOffset = 
dstLength = 17 


Result of findAndcopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuffer . length = 16 
dstOffset = 
dstLength =16 


Result of fincJAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21,22,23 


P1 


1 


P2 


2,3,4,5,6 


P3 


7,8,9, 10 


CI 


Does not apply for ProactiveHandler 



6.2.7.16 



Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 



Test Area Reference API_2_PAH_FACRB_BS 



6.2.7.16.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java. lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.16.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UNAV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

6.2.7.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 
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• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.7.16.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.7.16.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.16.3 



Test Suite files 

API_2_PAH_FACRB_BS_1 .scr 
API_2_PAH_FACRB_BS_1 .Java 
API_2_PAH_FACRB_BS_1 .Idr 
API_2_PAH_FACRB_BS_1 .clr 
API_2_PAH_FACRB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

compareBuf f er . length 
compareBuffer.length = 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 




9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




12 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

compareOf f set = 2 


Result is +1 




15 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

compareBuf fer . length = 17 

compareOf f set = 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length =16 

compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 

compareOf fset = 


Result is +1 





6.2.7.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 
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CRR number 


Test case number 


N5 


10, 14 


N6 


15,16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Handler 



6.2.7.1 7 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PAH_FACRBBS_BSS 

6.2.7.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[l compareBuffer, 
short compareOffset, 
short compareLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.17.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.7.17.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

6.2.7.17.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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6.2.7.17.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.17.3 



Test Suite files 

API_2_PAH_FACRBBS_BSS_1 .scr 
API_2_PAH_FACRBBS_BSS_1 .Java 
API_2_PAH_FACRBBS_BSS_1 .Idr 
API_2_PAH_FACRBBS_BSS_1 .clr 
API_2_PAH_FACRBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 

>compareBuf f er . length 
compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDisplayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



172 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


12 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown. 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


InitDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuffer . length = 17 
compareOf f set = 
compareLength = 17 


Result is OOh 




24 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuffer . length =16 
compareOf f set = 
compareLength =16 


Result is OOh 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf fset = 
compareLength = 17 


Result is +1 





6.2.7.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16,19 


N6 


23,24 


PI 


1 


P2 


2, 3, 4, 5, 6 


PS 


7,8,9, 10 


P4 


11 


CI 


Does not apply for Proactive Handler 



6.2.7.18 Method appendArray 

Test Area Reference: API 2 PAH APDA BSS 
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6.2.7.18.1 



Conformance requirement: 



The method with following header shall be compliant to its definition in the API. 

void appenciArray (byte [ ] buffer, 
short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.18.1.1 Normal execution 

• CRRN 1 : appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

6.2.7.18.1.2 Parameters error 

• CRRPl: if buffer is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang. ArraylndexOutOfBoundsException is thrown. 



6.2.7.18.1.3 



Context errors 



CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



6.2.7.18.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.18.3 



Test suite files 

API_2_PAH_APDA_BSS_1 .scr 
API_2_PAH_APDA_BSS_1 .Java 
API_2_PAH_APDA_BSS_1 .Idr 
API_2_PAH_APDA_BSS_1 .clr 
API_2_PAH_APDA_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer.length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Handler overflow 

buf fer . length = 256 
offset = 
length = 256 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




8 


Initialize handler 








Select Command Details TLV 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




9 


Clear the handler 








Successful call 

buffer = FF FE ... F8 
offset = 
length = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuffer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Clear the handler 








Successful call 

buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 01 ... FC 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 





6.2.7.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for ProactiveHandler 



6.2.7.1 9 Method appendTLV(byte tag, byte value) 

Test Area Reference: API 2 PAH APTLBB 
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6.2.7.19.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

6.2.7.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.19.1.2 Parameters error 
No requirements 



6.2.7.19.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



6.2.7.19.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.19.3 



Test suite files 

API_2_PAH_APTLBB_l.scr 
API_2_PAH_APTLBB_l.java 
API_2_PAH_APTLBB_1 .Idr 
API_2_PAH_APTLBB_1 .clr 
API_2_PAH_APTLBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 251 








Handler Overflow: Call the appendlLVQ 
method 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 01 00 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 01 00 01 01 FE 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Clear the handler 








Call appendArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 

Successful call 

tag = 84h 
value = OOh 

Call getLengthO method 


result = 253 






Call copyO method 








Compare the array 

compareBuffer = 00 81 F7 03 04 ... F9 84 01 
00 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





6.2.7.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



6.2.7.20 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_PAH_APTLBBB 

6.2.7.20.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

6.2.7.20.1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.20.1 .2 Parameters error 
No requirements 

6.2.7.20.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

6.2.7.20.2 Test suite files 

Test Script: API_2_PAH_APTLBBB_l.scr 

Test Applet: API_2_PAH_APTLBBB_l.java 

Load Script: API_2_PAH_APTLBBB_l.ldr 
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Cleanup Script: 
Parameter File: 

6.2.7.20.3 



API_2_PAH_APTLBBB_1 .clr 
API_2_PAH_APTLBBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitDisplayTextO 

length = 250 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuffer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 249 

buffer = 00 81 F6 03 04 ... F8 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 00 81 F6 03 04 ... F8 84 02 
00 01 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





6.2.7.20.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,4,5 


N2 


2 


C1 


1 


C2 


Does not apply for Proactive Handler 



6.2.7.21 



Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 



Test Area Reference: API 2 PAH APTLB BSS 
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6.2.7.21.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.7.21 .1 .1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successfiil append does not modify the TLV selected. 

6.2.7.21 .1 .2 Parameters error 

• CRRPl: if value is null, a java.lang. NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang. ArraylndexOutOfBoundsException is thrown. 



6.2.7.21.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 



6.2.7.21.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.21.3 



Test suite files 

API_2_PAH_APTLB_BSS_l.scr 
API_2_PAH_APTLB_BSS_l.java 
API_2_PAH_APTLB_BSS_1 .Idr 
API_2_PAH_APTLB_BSS_1 .clr 
API_2_PAH_APTLB_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueoffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is tfirown 




3 


valueOffset < 

value.length = 5 
valueoffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tfirown 




4 


valueLength > value.length 

value . length = 5 
valueoffset = 
valueLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



180 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


5 


valueOffset + valueLength > value.length 

value . length = 5 
valueOffset = 3 
valueLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


valueLength < 

value . length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 
valueLength = 254 


Tooll<itException. HANDLER OVE 
RFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Verify Current TLV: Call getvaiueLength ( ) 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copyO method 








Compare the arrays 

compareBuffer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 




13 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayConn 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Clear the handler 

Successful call 

tag = 04 

value = 00 01 ... F9 
valueOffset = 
valueLength = 250 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 


Result of 






compareBuf fer = 04 81 FA 00 01. ..F9 


javacard.framework.Util.arrayCom 
pare() is OOh 





6.2.7.21.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for Proactive Handler 


C3 


8 



6.2.7.22 



Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 



Test Area Reference: API_2_PAH_APTLBB_BSS 

6.2.7.22.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2, 
short value2of f set , 
short value21ength) 
throws Java . lang.NullPointerException, 

Java . lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

6.2.7.22.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.22.1 .2 Parameters error 

• CRRPl: if value2 is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a Java. lang. ArraylndexOutOfBoundsException is thrown. 



6.2.7.22.1.3 



Context errors 



• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER OVERFLOW. 
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• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



6.2.7.22.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.22.3 



Test suite files 

API_2_PAH_APTLBB_BSS_1 .scr 
API_2_PAH_APTLBB_BSS_1 .Java 
API_2_PAH_APTLBB_BSS_1 .Idr 
API_2_PAH_APTLBB_BSS_1 .clr 
API_2_PAH_APTLBB_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


value2Length < 

value2 . length = 5 
value20ffset = 
value2Length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter 

value2 . length = 256 
value20ffset = 
value2Length = 256 


Tooll<itException.BAD_INPUT_PA 
RAIVIETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 

tag = 04 
valuel = 05 
value2 = FF FE ... F8 
value20ffset = 
value2Length = 8 








Call copyO method 








Compare the arrays 

CompareBuffer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call 

tag = 85h 
valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

compareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copvO method 








Compare the arrays 

CompareBuf fer = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copyO method 








Compare the arrays 

compareBuffer = 04 81 80 00 01. ..7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




14 


Clear the handler 








Successful call 

tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length = 249 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuffer = 04 81 FA 00 01. ..F9 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





6.2.7.22.4 



Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for Proactive Handler 


C3 


8 



6.2.7.23 Method clear 

Test Area Reference: AP1_2_PAH_CLER 
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6.2.7.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void clear ( ) 

throws ToolkitException EditHandler 

6.2.7.23.1.1 Normal execution 

• CRRN 1 : Clears the TLV list of an EditHandler 

• CRRN2: Resets the current TLV selected. 



6.2.7.23.1.2 
No requirements 

6.2.7.23.1.3 



Parameters error 



Context errors 



• CRRC 1 : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE 



6.2.7.23.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.23.3 



Test suite files 

API_2_PAH_CLER_1 .scr 
API_2_PAH_CLER_1 .Java 
API_2_PAH_CLER_1 .Idr 
API_2_PAH_CLER_1 .ck 
API_2_PAH_CLER_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 

Select Command Details TLV 
Call the getLengthQ method 


Result of getLengthQ is not null 






Clear the handler 

Call the getLengthQ method 


Result of getLengthQ is 




2 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ELEMENT 
is thrown 





6.2.7.23.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


CI 


Does not apply for Proactive Handler 



6.2.8 Class ProactiveResponseHandler 
6.2.8.1 Method copyAdditionallnformation 

Test Area Reference: API_2_PRH_CPAI_BSS 
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6.2.8.1.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copyAdditionallnformation (byte [ ] dstBuffer^ 

short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException^ 
ToolkitException 



6.2.8.1.1.1 



Normal execution 



• CRRN 1 : The copyAdditionalInformation() method shall copy a part of the additional information field from 
Result TLV element in dstBuffer, using dstOffset and dstLength. 

• CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

• CRRN3: The method returns (dstOffset + dstLength). 

• CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 

• CRRN5: The method shall copy from the first Result TLV. 

6.2.8.1.1.2 Parameter errors 

• CRRP 1 : A NullPointerException shall be thrown if dstBuffer is null. 

• CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 



6.2.8.1.1.3 



Context errors 



CRRCl: A ToolkitException. UN AVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLength is greater than the 
value field of the available TLV. 



6.2.8.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.1.3 



Test Suite files 

API_2_PRH_CPAI_BSS_Lscr 
API_2_PRH_CPAI_BSS_1 .Java 
API_2_PRH_CPAI_BSS_1 .Idr 
API_2_PRH_CPAI_BSS_1 .ck 
API_2_PRH_CPAI_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = 

dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 

Result TLV = 03 OC 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

dstBuffer = NULL 


NullPointerException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


dstOffset > dstBuffer.length 

dstBuffer. length = 10 
dstOffset = 11 
dstLength = 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 01 23 45 67 89 








Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 

Result TLV = 03 07 01 AB CD EF FE DC BA 








Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




11 


Compare dstBuffer using arrayCompare() 

src = {AB, CD, EF, FE, DC} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareQ is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7 additional bytes 

Result TLV = 03 08 01 FE DC BA 98 76 54 
32 








Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 7 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




13 


Compare dstBuffer using arrayCompare() 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 8 additional bytes 

Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successful call, dstBuffer is the whole buffer 

dstBuffer. length = 9 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 




15 


Compare dstBuffer using arrayCompareQ 

src = {00, 11, 22, 33, 44} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 01 00 01 02 03... 








Successful call to the method 

dstBuffer .length = F2h 
dstOffset = 
dstLength = F2h 


result of 

copyAdditionallnformationO is 
F2fi. 




17 


Compare dstBuffer using arrayCompareQ 

src = {00, 01, 02, 03, 04...} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 


result of arrayCompareO is OOh. 




18 


Call the getValueLengthO method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

dstBuffer .length = 6 
dstOffset = 
dstLength = 6 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 

Result TLV = 03 06 01 00 11 22 33 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionallnformationQ method 

dstBuffer. length = 20 
dstOffset = 5 
dstLength = 5 








Compare dstBuffer using arrayCompareQ 

src = { 

OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 
OAh, OBh, OCh, ODh, OEh, 
OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 


result of arrayCompareO is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 
elements 

1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successful call to copyAdditionallnformationQ 

dstBuffer . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




22 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getValueLengthO method 


Result is 06h. 




24 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown by send() 






ProactiveResponseHandler, getTheHandler 
call copyAdditionallnformationQ 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 





6.2.8.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 11, 13, 15, 17,20,22 


N2 


20 


N3 


7, 10, 12, 14, 16,21 


N4 


9, 18,23 


N5 


21, 22,23 


PI 


1 


P2 


2,3,4,5,6 


CI 


24 


C2 


19 



6.2.8.2 Method copyTextString 

Test Area Reference: API_2_PRH_CPTS_BS 

6.2.8.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 



6.2.8.2.1.1 



Normal execution 



• CRRNl: The copyTextStringO method copies the text string value from the first Text String TLV element, using 
dstBuffer and dstOffset. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

• CRRN3: The method returns (dstOffset + length of copied value). 
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6.2.8.2.1 .2 Parameter errors 

• CRRP 1 : A NullPointerException shall be thrown if dstBuffer is null. 

• CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the 
TextString to be copied, without the Data Coding Scheme included), as specified for the returned value, would 
cause access outside array bounds. 



6.2.8.2.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



6.2.8.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.2.3 



Test Suite files 

API_2_PRH_CPTS_BS_1 .scr 
API_2_PRH_CPTS_BS_1 .Java 
API_2_PRH_CPTS_BS_1 .Idr 
API_2_PRH_CPTS_BS_1 .clr 
API_2_PRH_CPTS_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO ; 

call the copyTextStringO method with a null 
dstBuffer 

dstBuffer = null 
dstOffset = 


NullPointerException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response 

Text String TLV = OD 04 04 "ABC" 








dstOffset + text length > dstBuffer.length 

dstBuffer .length = 04h 
dstOffset = 02h 


ArraylndexOutOfBoundsException 
is thrown 




3 


dstOffset < 

dstBuffer.length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerO ; 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with a null Text String tlv 

Text String TLV = OD 00 








Initialize dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStrlngO method 

dstBuffer. length = 04h 
dstOffset = 02h 


Result of copyTextStrlngO is 02h 




6 


Compare dstBuffer using arrayCompare() 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = Olh 

Text String TLV = OD 02 04 41 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStrlngO method 

dstBuffer .length = 04h 
dstOffset = OOh 


Result of copyTextStrlngO Is 01 h 




8 


Compare dstBuffer using arrayCompare() 

src = {41h, Olh, 02h, 03h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO Is OOh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with text length = 02h 

Text String TLV = OD 03 04 42 43 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStrlngO method 

dstBuffer .length = 04h 
dstOffset = 02h 


Result of copyTextStrlngO is 04h 




10 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




11 


Call the getValueLengthO method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStrlngO method 

dstBuffer .length = 7Eh 
dstOffset = OOh 


Result of copyTextStrlngO is 7Eh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Compare dstBuffer using arrayCompare() 

src = {Olh, ..., 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getValueLengthO method 


Result is 7Fh 




15 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ...7F 








Initialize dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = lOh 


Result of copyTextStringO is 8Fh 




16 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh,... OFh, 
Olh, ...7Fh, 8Fh, ... FFh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 








Call the copyTextStringO method 

dstBuffer .length = FFh 
dstOffset = OOh 


Result of copyTextStringO is EFh 




18 


Compare dstBuffer using arrayCompare() 

src = {Olh, ...EFh, OOh ... OOh } 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 

1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 

dstBuffer .length = 04h 
dstOffset = 02h 


Result of copyTextStringO is 04h 




20 


Compare dstBuffer using arrayCompare() 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getValueLengthO method 


Result is 03h 
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6.2.8.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


6,8, 10, 13, 16, 18,20 


N2 


11, 14,21 


N3 


5,7,9, 12, 15, 17, 19 


P1 


1 


P2 


2,3 


C1 


4 



6.2.8.3 



Method getAdditionallnformationLength 



Test Area Reference: API_2_PRH_GTIL 

6.2.8.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionallnformationLength ( ) 
throws ToolkitException 



6.2.8.3.1.1 



Normal execution 



• CRRNl: This method returns the length of the additional information field from the first Result TLV in the 
ProactiveResponseHandler. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 



6.2.8.3.1.2 

No requirements. 

6.2.8.3.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException. UN AVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 



6.2.8.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.3.3 



Test Suite files 

API_2_PRH_GTIL_Lscr 
API_2_PRH_GTIL_1 .Java 
API_2_PRH_GTIL_1 .Idr 
API_2_PRH_GTIL_1 .clr 
API_2_PRH_GTIL_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information 








ProactiveResponseHandler.getTheHandlerO ; call 
the getAdditionallnformationLengthQ method 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 1 additional byte 

Result TLV = 03 02 02 55 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthO 

method 


Result is 01 h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerQ ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 80h 




10 


Call the getValueLengthO method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is F2h 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 03 02 01 23 
2ncl Result TLV = 03 01 00 








ProactiveResponseHandler.getTheHandlerO ; 

call the getAdditionallnformationLengthO 

method 


Result is 02h 




14 


Call the getValueLengthO method 


Result is 03h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response without Result Simple TLV 


ToolkitException . UNAVAI LABLE_E 
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Id 


Description 


API Expectation 


APDU Expectation 






LEMENT is thrown by send() 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthO 
method 


ToolkitException . UNAVAI LABLE_E 
LEMENT is thrown by 
getAdditionallnformationLength {) 





6.2.8.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3,5,7,9, 11, 13 


N2 


2,4,6,8, 10, 12, 14 


C1 


15 



6.2.8.4 Method getGeneralResult 

Test Area Reference: API_2_PRH_GTGR 

6.2.8.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

6.2.8.4.1.1 Normal execution 

• CRRNl: This method returns the general result of a proactive command. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 



6.2.8.4.1.2 

No requirements. 

6.2.8.4.1.3 



Parameter errors 



Context errors 



CRRCl: A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Simple TLV. 



6.2.8.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.4.3 



Test Suite files 

API_2_PRH_GTGR_1 .scr 
API_2_PRH_GTGR_1 .Java 
API_2_PRH_GTGR_1 .Idr 
API_2_PRH_GTGR_1 .ck 
API_2_PRH_GTGR_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 




DISPLAY TEXT Proactive 
command 
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Id 


Description 


API Expectation 


APDU Expectation 




dcs = 04h 
buffer = 'Text' 








Terminal Response with General Result = 00 
(command performed successfully) 








ProactiveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 

without Additional information on result 

(command performed with partial 

comprehension) 








ProactiveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is 80h 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResult ( ) method 


Result is 02h 




12 


Call the getValueLengthO method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


ToolkitException . UNAVAI LABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandlerQ ; 
call the getGeneralResultO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without General Result 
Byte in Result Simple TLV 


ToolkitException. UNAVAILABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandlerO ; 

call the getGeneralResultO method 
Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 11 


N2 


2,4,6,8, 10, 12 


CI 


13 


C2 


14 



6.2.8.5 Method getltem Identifier 

Test Area Reference: API_2_PRH_GTII 

6.2.8.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

6.2.8.5.1.1 Normal execution 

• CRRNl: The method returns the item identifier byte value from the first Item Identifier TLV element. 

• CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 



6.2.8.5.1.2 

No requirements. 



Parameter errors 
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6.2.8.5.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item 
Identifier TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the item identifier byte is 
missing in the Item Identifier Simple TLV. 



6.2.8.5.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.5.3 



Test Suite files 

API_2_PRH_GTII_1 .scr 
API_2_PRH_GTII_1 .Java 
API_2_PRH_GTII_1 .Idr 
API_2_PRH_GTII_1 .cb- 
API_2_PRH_GTII_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Item Identifier TLV 
available) 








Call to getltemldentifierO with unavailable Item 
Identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEM command with 
2items(ID=01,02) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 








Call the getltemldentifierO method 


Result is 01 h 




3 


Call the getValueByteO method 

valueOffset = OOh 


Result is 01 h 




4 


Build and send a SELECT ITEM command with 
3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getltemldentifierO method 


Result is 05h 




5 


Call the getValueByteO method 

valueOffset = OOh 


Result is 05h 




6 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getltemldentifierO method 


Result is FFh 




7 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with 2 Item Identifier tlv 

1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getltemldentifierO method 


Result is FFh 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without item identifier in 
the Item Identifier Simple TLV 

Item Identifier TLV = 10 00 








Call to getltemldentifierO 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 4, 6, 8 


N2 


3, 5, 7, 9 


C1 


1 


C2 


10 



6.2.8.6 Method getTextStringCodingScheme 

Test Area Reference: API_2_PRH_GTCS 

6.2.8.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

6.2.8.6.1.1 Normal execution 

• CRRNl: This method returns the data coding scheme from the first Text String TLV element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



6.2.8.6.1.2 

No requirements. 

6.2.8.6.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUND ARIES shall be thrown if the Text String TLV is present 
with a length of 0. 



6.2.8.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PRH_GTCS_1 .scr 
API_2_PRH_GTCS_1 .Java 
API_2_PRH_GTCS_1 .Idr 
API_2_PRH_GTCS_1 .ck 
API_2_PRH_GTCS_1 .par 
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6.2.8.6.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringCodingSchemeO with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringCodingSchemeO method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, dcs 

= 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringCodingSchemeO method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is 03h 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO method 


Result is 08h 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringCodingSchemeO method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is aOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 08h 

Text String TLV = OD 81 FO 08 01 02 ... EE 
EF 








Call the getTextStringCodingSchemeO method 


Result is 08h 




12 


Call the getValueLengthO method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringCodingSchemeO method 


Result is 04h 




14 


Call the getValueLengthO method 


Result is 02h 





6.2.8.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5,7,9, 11, 13 


N2 


4,6,8, 10, 12, 14 


CI 


1 


C2 


2 



6.2.8.7 Method GetTextString Length 

Test Area Reference: API_2_PRH_GTTL 

6.2.8.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getTextStringLength ( ) 

throws ToolkitException 



6.2.8.7.1.1 



Normal execution 



• CRRN 1 ; The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 



6.2.8.7.1.2 

No requirements. 

6.2.8.7.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 
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6.2.8.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.7.3 



Test Suite files 

API_2_PRH_GTTL_1 .scr 
API_2_PRH_GTTL_1 .Java 
API_2_PRH_GTTL_1 .Mr 
API_2_PRH_GTTL_1 .clr 
API_2_PRH_GTTL_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringLengthO method 


Result is OOh 




3 


Call the getValueLengthO method 


Result is OOh 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringLengthO method 


Result is 01 h 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = 08h 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringLengthO method 


Result is 7Fh 




11 


Call the getValueLengthO method 


Result is 80h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 
EF 








Call the getTextStringLengthO method 


Result is EFh 




13 


Call the getValueLengthO method 


Result is FOh 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringLengthO method 


Result is 01 h 




15 


Call the getValueLengthO method 


Result is 02h 





6.2.8.7.4 



Test Coverage 



CRR number 


Test case number 


1 


2,4, 6,8, 10, 12, 14 


2 


3,5,7,9, 11, 13, 15 


3 


1 



6.2.8.8 Method getTheHandler 

Test Area Reference: API_2_PRH_GTHD 

6.2.8.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 

6.2.8.8.1.1 Normal execution 

• CRRNl: The method shall return the single system instance of the ProactiveHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 



6.2.8.8.1.2 

No requirements. 



Parameter errors 
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6.2.8.8.1.3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AV AILABLE if the handler is busy. 

Test Suite files 

API_2_PRH_GTHD_1 .scr 
API_2_PRH_GTHD_1 .Java 
API_2_PRH_GTHD_1 .Idr 
API_2_PRH_GTHD_1 .clr 
API_2_PRH_GTHD_1 .par 



6.2.8.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



6.2.8.8.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








getTheHandlerO twice 


The returned objects shall be the 
same 




2 


getTheHandlerO 


The reference shall be a 
ProactiveResponseHandler 




3 


getTheHandlerO 


The reference shall not be null 





6.2.8.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


To be checked in Framework tests and insert here cross reference 


C1 


To be checked in Framework tests and insert here cross reference 



6.2.8.9 Method getLength 

Test Area Reference API_2_PRH_GLEN 

6.2.8.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.8.9.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.8.9.1 .2 Parameter errors 
No requirements. 

6.2.8.9.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AV AILABLE. 
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6.2.8.9.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.9.3 



Test Suite files 

API_2_PRH_GLEN_l.scr 
API_2_PRH_GLEN_1 .Java 
API_2_PRH_GLEN_1 .Idr 
API_2_PRH_GLEN_1 .clr 
API_2_PRH_GLEN_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerO 

getLength () 


Result of getLengthO is 1 2 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerO 
getLengthO 


Result of getLengthO is FFh 





6.2.8.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for Proactive Response Handler 



6.2.8.10 Method copy 

Test Area Reference API_2_PRH_COPY_BSS 



6.2.8.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.8.10.1.1 Normal execution 

• CRRNl: copies the simple TLV list contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.8.10.1.2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 
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• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of TooUcitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 



6.2.8.10.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.10.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.10.3 



Test Suite files 

API_2_PRH_COPY_BSS_Lscr 
API_2_PRH_COP Y_BSS_1 .Java 
API_2_PRH_COP Y_BSS_1 .Idr 
API_2_PRH_COPY_BSS_l .clr 
API_2_PRH_COPY_BSS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 








ProactiveResponseHandler.getTheHandlerO 
copyO with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copyO is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyO is 15 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

03 01 00 

OF 10 11 12 13 


Result of arrayCompareO is 




12 


Initialize dstBuffer 

dstBuffer = OOh Olh 02h ... 13h 








Successful call, dstBuffer is part of a buffer 

dstBuffer. length = 20 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




13 


Compare the whole buffer 

Reference = 

00 01 02 

81 03 01 21 00 

02 02 82 81 

OC OD OE 

OF 10 11 12 13 


Result of arrayCompareO is 





6.2.8.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


PI 


1 


P2 


2,3,4,5,6 


P3 


7 


CI 


Does not apply for Proactive Response Handler 



6.2.8.11 Method findTLV 

Test Area Reference API_2_PRH_FINDBB 

6.2.8.1 1 .1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.8.11.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 

is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.8.11.1.2 Parameter errors 

• CRRP 1 : if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.8.11.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.8.11.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.11.3 



Test Suite files 

API_2_PRH_FINDBB_1 .scr 
API_2_PRH_FINDBB_1 .Java 
API_2_PRH_FINDBB_1 .Idr 
API_2_PRH_FINDBB_1 .clr 
API_2_PRH_FINDBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

81 03 01 21 00 

82 02 82 81 
03 01 00 

03 02 01 12 








findTLVO with Invalid input parameter 

occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 




2 


Search 1st TLV 

tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result is 03h 




4 


Search 2nd TLV 

tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

tag = Olh 
occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

tag = 03h 
occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result is 01 h 




12 


Search 3rd TLV 

tag = 03h 
occurrence = 2 


Result is 
TLV_FOUND_CR_NOT_SET 




13 


Call the getValueLengthO method 


Result is 02h 




14 


Search tag 83h 

Tag = 83h 
Occurrence = 1 


Result is 
TLV_FOUND_CR_NOT_SET 




15 


Search tag 82h 

Tag = 82h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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6.2.8.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


3,5, 11, 13 


N2 


2,4 


N3 


10, 12 


N4 


6, 7,8, 9 


N5 


14,15 


P1 


1 


C1 


Does not apply for Proactive Response Handler 



6.2.8.12 Method getValueLength 

Test Area Reference API_2_PRH_GVLE 

6.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 



6.2.8.12.1.1 



Normal execution 



• CRRN 1 : gets and returns the binary length of the value field for the last TLV element which has been found in 
the handler. 



6.2.8.12.1.2 
No requirements. 

6.2.8.12.1.3 



Parameter errors 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.12.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.12.3 



Test Suite files 

API_2_PRH_GVLE_1 .scr 
API_2_PRH_GVLE_1 .Java 
API_2_PRH_GVLE_1 .Idr 
API_2_PRH_GVLE_1 .clr 
API_2_PRH_GVLE_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 00 








ProactiveResponseHandler.getTheHandlerO 

GetValueLength ( ) 


ToolkitException. UNAVAILABLE 
ELEMENT Is thrown 




2 


Search TLV ODh 








getValueLength ( ) 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 
7F 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is FOh 





6.2.8.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for Proactive Response Handler 


02 


1 



6.2.8.13 Method getValueByte 

Test Area Reference API_2_PRH_GVBYS 

6.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 



6.2.8.13.1.1 



Normal execution 



CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 
byte). 



6.2.8.13.1.2 



Parameter errors 



CRRPl: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.8.13.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooMtException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.13.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.13.3 



Test Suite files 

API_2_PRH_GVBYS_l.scr 
API_2_PRH_GVB YS_1 .Java 
API_2_PRH_GVB YS_1 .Idr 
API_2_PRH_GVB YS_1 .clr 
API_2_PRH_GVB YS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandlerO 








getValueByte(O) 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByteO) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result is 82h (Source) 




5 


Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




7 


GetValueByte (7F) 


Result is 7Fh 




8 


GetValueByte (EF) 


Result is EFh 





6.2.8.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for Proactive Response Handler 


02 


1 



6.2.8.14 Method copyValue 

Test Area Reference API 2 PRH CPYVS BSS 
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6.2.8.14.1 



Conformance requirement 



The method with following header shall be compliant with its definition in the API. 

public short copyValue (short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.8.14.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.8.14.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.8.14.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.14.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.14.3 



Test Suite files 

API_2_PRH_CPYVS_BSS_1 .scr 
API_2_PRH_CPYVS_BSS_l.java 
API_2_PRH_CPYVS_BSS_1 .Idr 
API_2_PRH_CPYVS_BSS_1 .clr 
API_2_PRH_CPYVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 








CopyValue with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstLength >dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer . length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer .length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


ValueOffset > Text String Length 

ValueOffset = 7 
dstBuffer .length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


ValueOffset < 

ValueOffset = -1 
dstBuffer .length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

ValueOffset = 
dstBuffer. length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

ValueOffset = 2 
DstBuffer. length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler 








CopyValueO 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




12 


Select Text String TLV 








Successful call 

ValueOffset = 
DstBuffer .length = 17 
DstOffset = 
DstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

ValueOffset = 2 
DstBuffer .length = 20 
DstOffset = 3 
DstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.8.14.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


PI 


1 
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CRR number 


Test case number 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


C1 


Does not apply for Proactive Response Handler 


C2 


11 



6.2.8.15 Method compareValue 

Test Area Reference API_2_PRH_CPRVS_BSS 



6.2.8.15.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
Toolkit Except ion 

6.2.8.15.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRN 1 : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.8.15.1.2 Parameter errors 

• CRRP 1 : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.8.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.15.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PRH_CPRVS_BSS_1 .scr 
API_2_PRH_CPRVS_BSS_1 .Java 
API_2_PRH_CPRVS_BSS_1 .Idr 
API_2_PRH_CPRVS_BSS_1 .ck 
API_2_PRH_CPRVS_BSS_1 .par 
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6.2.8.15.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 








compareValueQ with a null compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itExGeption.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








CompareValue () 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown 




12 


Select Text String TLV 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers 

ValueOffset = 
CompareOffset = 
CompareLength = 17 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




15 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

ValueOffset = 2 
CompareOf f set = 3 
CompareLength = 12 


Result is OOh 




16 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 





6.2.8.15.4 



Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


CI 


Does not apply for Proactive Response Handler 


C2 


11 



6.2.8.1 6 Method findAndCopyValue(byte tag, byteQ dstBuffer, short valueOffset) 

Test Area Reference API_2_PRH_FACYB_BS 

6.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws Java . lang. NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 
ToolkitException 
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6.2.8.16.1.1 



Normal execution 



• CRRNl: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.8.16.1.2 Parameter errors 

• CRRP 1 : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2; if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.8.16.1.3 



Context errors 



CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.8.16.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.16.3 



Test Suite files 

API_2_PRH_FACYB_BS_1 .scr 
API_2_PRH_FACYB_BS_1 .Java 
API_2_PRH_FACYB_BS_1 .Mr 
API_2_PRH_FACYB_BS_1 .clr 
API_2_PRH_FAC YB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








FindAndCopyValue with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



217 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 04h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Successful call 

Tag = ODh 

DstBuffer. length = 17 

DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

DstBuffer .length = 20 
DstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactiveResponseHandler.getTheHandlerO 








Successful call 

Tag = ODh 

DstBuffer .length = 17 

DstOffset = 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




13 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Successful call (with tag 8Dh) 

Tag = 8Dh 

DstBuffer. length = 17 

DstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





6.2.8.16.4 



Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


PI 


1 


P2 


2, 3, 4, 5 


01 


Does not apply for Proactive Response Handler 
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6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PRH_FACYBBS_BSS 

6.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws Java . lang . NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.8.17.1.1 Normal execution 

• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 



• 



CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 



• CRRN4: The search method is comprehension required flag independent. 

6.2.8.17.1.2 Parameter errors 

CRRPl: if dstBuffer is null NullPointerException shall be thrown. 



• 



• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.8.17.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.17.2 Test Suite files 

Test Script: API_2_PRH_FACYBBS_BSS_l.scr 

Test Applet: API_2_PRH_FACYBBS_BSS_Ljava 

Load Script: API_2_PRH_FACYBBS_BSS_l.ldr 

Cleanup Script: API_2_PRH_FACYBBS_BSS_Lclr 

Parameter File: API_2_PRH_FAC YBBS_BSS_1 .par 
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6.2.8.17.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT Is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueQ is 
17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 2 
DstBuffer .length = 20 
DstOffset = 3 
DstLength = 12 


Result of findAndcopyValueO is 
15 




15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 (no specific DCS 

byte) 








ProactiveResponseHandler.getTheHandlerO 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 
DstBuffer .length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueQ is 
17 




17 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




18 


Successful call 

Tag = ODh, occurrence = 2 
ValueOffset = 
DstBuffer . length = 6 
DstOffset = 
DstLength = 6 


Result of findAndCopyValueQ is 6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Successful call (with tag 8Dh) 

Tag = 8Dh, occurrence = 1 
ValueOffset = 
DstBuffer. length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueQ is 
17 




21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





6.2.8.17.4 



Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20,21 
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CRR number 


Test case number 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9, 10 


C1 


Does not apply for Proactive Response Handler 



6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PRH_FACRB_BS 

6.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws Java . lang. NullPointerException, 

Java .lang . ArraylndexOutOfBoundsException, 
ToolkitException 

6.2.8.18.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1 . 

• CRRN6: The search method is comprehension required flag independent. 

6.2.8.18.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.8.18.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.18.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PRH_FACRB_BS_1 .scr 
API_2_PRH_FACRB_BS_1 .Java 
API_2_PRH_FACRB_BS_1 .Idr 
API_2_PRH_FACRB_BS_1 .clr 
API_2_PRH_FACRB_BS_1 .par 
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6.2.8.18.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + length > 

compareBuf f er . length 
CompareBuffer.length = 20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 04h 


Tooll<itException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown. 




7 


Initialize compareBuffer 

CompareBuf fer = 
04 00 01 ... OF 








Compare buffers 

Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

GetValueLengthO 


Result is 17 




9 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




10 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




11 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOffset = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOf f set = 2 


Result is OOh 




13 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOf f set = 2 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

Tag = 8Dh 
CompareOf f set = 


Result is OOh 





6.2.8.18.4 



Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9,13 


N5 


10, 14 


N6 


15 


PI 


1 


P2 


2, 3, 4, 5 


01 


Does not apply for Proactive Response Handler 



6.2.8.1 9 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byteQ compareBuffer, short compareOffset, short compareLength) 



Test Area Reference API 2 PRH FACRBBS BSS 
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6.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOf f set, 
byte [ ] compareBuf f er, 
short compareOf f set , 
short compare Length) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
Toolkit Except ion 

6.2.8.19.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a 
buffer: 

CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

CRRN2: if the method is successful then the corresponding TLV becomes current. 

CRRN3: if identical is returned. 

CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

CRRN6: The search method is comprehension required flag independent. 

6.2.8.19.1.2 Parameter errors 

CRRPl: if compareBuffer is null NullPointerException shall be thrown. 

CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

6.2.8.19.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.19.2 Test Suite files 

Test Script: API_2_PRH_FACRBBS_BSS_Lscr 

Test Applet: API_2_PRH_FACRBBS_BSS_Ljava 

Load Script: API_2_PRH_FACRBBS_BSS_Lldr 

Cleanup Script: API_2_PRH_FACRBBS_BSS_Lclr 

Parameter File: API_2_PRH_FACRBBS_BSS_Lpar 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



225 



ETSI TS 151 013 V4.1.0 (2003-12) 



6.2.8.19.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + compareLength 

>compareBuf f er . length 
CompareBuffer.length = 5 
CompareOffset = 3 
CompareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAIVIETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCompareValueQ 

tag = ODh 
occurrence = 2 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEIVIENT is ttirown. 




13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

GetValueLengthO 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 
compareLength = 12 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerO 








Initialize compareBuffer 

compareBuf f er = 
04 00 01 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 55 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

compareBuffer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerQ 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag 8Dh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 





6.2.8.19.4 



Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17,20,21 


N4 


15, 18,22 


N5 


16, 19 


N6 


23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7,8,9,10 


P4 


11 


01 


Does not apply for Proactive Response Handler 
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6.2.9 Class ToolkitRegistry 
6.2.9.1 Method allocateTimer 

Test Area Reference: API_2_TKR_ATIM 

6.2.9.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) throws ToolkitException 

6.2.9.1.1.1 Normal execution 

• CRRNl: the returned timer identifier shall be between 01 and 08 inclusive. 

• CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 

• CRRN3: The SIM Toolkit Framework shall trigger the applet when receiving an ENVELOPE(TIMER 
EXPIRATION) command for the allocated timer. 

• CRRN4: A call to isEventSet() method for EVENT_TIMER_EXPIRATION should return true if the applet has 
at least one timer allocated. 

6.2.9.1 .1 .2 Parameters error 
No requirements. 

6.2.9.1.1.3 Context errors 

• CRRCl : Shall throw a ToolkitException with reason NO_TIMER_AVAILABLE if all the timers are allocated. 

• CRRC2: Shall throw a ToolkitException with reason NO_TIMER_AVAILABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

6.2.9.1.2 Test suite files 

Test Script: API_2_TKR_ATIM_l.scr 

Test Applet: API_2_TKR_ATIM_l.java 

API_2_TKR_ATIM_2.java 

API_2_TKR_ATIM_3 .j ava 

• Installation parameters: 

• For this test procedure the non-volatile memory of each instance is 200 (Hexa). 

• The maximum timer parameter value is as follows for each applet: 

- applet: (API_2_TKR_ATIM_1): 8 timers 

- applet2 (API_2_TKR_ATIM_2): 4 timers 

- applets (API_2_TKR_ATIM_3): timer 
Load Script: API_2_TKR_ATIM_l.ldr 

• The load script installs the 6 instances. 
Cleanup Script: API_2_TKR_ATIM_l.clr 
Parameter File: API_2_TKR_ATIM_1 .par 
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6.2.9.1.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(appletl) 

8 * allocateTimer . 


No exception shall be thrown. 

Timer ID returned shall be between 

01 and 08 inclusive. It shall be 

different after each call. 




2 


Allocate timers more than the maximum 
(appletl) 

The appletl allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 

ENVELOPE(TIMER EXPIRATION) command 

(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Calls releaseTimer (id) each time a timer 
expires . 


Shall trigger each time an 

ENVELOPE(TIMER EXPIRATION) 

is sent to the SIM, for Timer ID = 

'01 'to '08'. 




4 


Allocate up to 4 timers 
(applet2) 

4 * allocateTimer . 


No exception shall be thrown. Each 
time, the returned timer identifier 

shall be between '01' and '08' 

inclusive. It shall be different after 

each call. 




5 


Allocate timers more than the maximum 
(applet3) 

The applets allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





6.2.9.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,4 


N2 


1,4 


N3 


3 


N4 


1 


C1 


2 


C2 


5 



6.2.9.2 Method changeMenuEntry 

Test Area Reference: API_2_TKR_CMETB_BSSBZBS 

6.2.9.2.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void changeMenuEntry (byte id, 

byte[] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte IconQualif ier, 
short iconldentifier) 
throws Java . lang . NullPointerException, 

Java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 
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6.2.9.2.1.1 Normal execution 

• CRRNl: The SIM Toolkit Framework shall dynamically update the menu stored in the ME by issuing a SET UP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

• CRRN2: The default state of the changed menu entry is 'enabled'. 

• CRRN3: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true before and after the 
call. 

• CRRN4: if helpSupported was true then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

• CRRN5: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

• CRRN6: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80' 

• CRRN7: if helpSupported was false and if no entries is supporting help then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return false . 

• CRRN8: if helpSupported was false and if no entries is supporting help then after the completion of the SETUP 
MENU command, if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the 
SIM, then the SIM Toolkit framework shall not trigger the applet. 

• CRRN9: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 
provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

• CRRNIO: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

• CRRNl 1 : If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to as defined in 3GPP TS 51.014 [4]. 

6.2.9.2.1.2 Parameters error 

• CRRPl: Shall throw java.lang.NullPointerException - if menuEntry is null 

• CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

• CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

• CRRP4: Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 

6.2.9.2.1.3 Context errors 

• CRRCl : Shall throw a ToolkitException with MENU_ENTRY_NOT_FOUND reason if the Menu Identifier 
isn't associated to the calling applet instance. 

• CRRC2: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 
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6.2.9.2.2 Test suite files 
Additional requirements for tlie GSM personalization: 

content of EF sume shall be: 

• Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_CMETB_BBSSBZBS_l.scr 

Test Applet: API_2_TKR_CMETB_BBSSBZBS_l.java 

- entry'01'is"Initl" 

- entry '02' is "Init2" 

• Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 
Maximum number of menu entries: 2 

Position / Identifier for each menu entry: '01'/'01','02'/'02' 
Load Script: API_2_TKR_CMETB_BBSSBZBS_l.ldr 

Cleanup Script: API_2_TKR_CMETB_BBSSBZBS_l.clr 

Parameter File: API_2_TKR_CMETB_BBSSBZBS_1 .par 

6.2.9.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet changes the entry's title by menuEntry 

buffer, with a greater length than the initial 

length 

1- ChangeMenuEntry ( ) with parameters: 

Id = '02' 

MenuEntry = "UseAllBuf f er " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- shall return true. 

3- shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Changing the title with part of menuEntry 
buffer 

1- ChangeMenuEntry with parameters: 








Id = '01' 

MenuEntry = "UsePartOfBuf f er " 


1- No exception shall be thrown. 






Offset = 3 








Length = 12 


2- Shall return true. 






NextAction = 








HelpSupported = false 


3- Shall return false. 






IconQualif ier = 








Iconldentif ier = 0. 








2- isEventSet (EVENT_MENU_SELECTION) . 




The SIIVI shall issue a 




3- 




SETUP MENU proactive 




isEventSet (EVENT_MENU_SELECTION_HELP_R 




command which contains 




EQUEST) 




the new text for entry ID 
'01'. 


3 


Length = 

1- ChangeMenuEntry ( ) for entry '01' and 
entry '02', with parameters: 

Id = '01'/'02' 

MenuEntry = "LengthEqualsO " 








Offset = 


1- No exception shall be thrown. 






Length = 








NextAction = 


2- Shall return true. 






HelpSupported = false 








IconQualif ier = 


3- shall return false. 






Iconldentif ier = 0. 








2- isEventSet (EVENT_MENU_SELECTION) . 








3- 




The SIM shall issue a 




isEventSet (EVENT_MENU_SELECTION_HELP_R 




SETUP MENU proactive 




EQUEST) . 




command which contains 
for entry '01 'and entry '02', 
no text part. 


4 


Setting a next action indicator != 

1- changeMenuEntry () with parameters: 

Id = '02' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 

NextAction = '10' (SETUP CALL) 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 








2- IsEventSet (EVENT_MENU_SELECTION) . 


1- No exception shall be thrown. 

2- Shall return true. 






3- 


3- Shall return false. 






isEventSet (EVENT_MENU_SELECTION_HELP_R 








EQUEST) . 








4- ChangeMenuEntry with parameters: 








Id = '02' 








MenuEntry = "NextActionlndic" 








Offset = 








Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 




The SIM shall issue a 




HelpSupported = true 




SETUP MENU proactive 




IconQualif ier = 




command which contains an 




Iconldentif ier = 




Items Next Action Indicator 
list and which contains a 
command qualifier '80'. 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 


Applet is trigged by a 
IVIENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 02 




6 


help supported=true 

1- changeMenuEntry ( ) with parameters: 

Id = '01' 

MenuEntry = "HelpSupported" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = true 

IconQualif ier = 

Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 


7 


Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 


Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 01 




8 


Setting icons, help supported = false 

1- ChangeMenuEntry ( ) for entries 
'01', '02', with parameters: 

Id = '01'/'02' 

MenuEntry = " IconQualif ier " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = '01' 

Iconldentifier = '02' / '01' 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 


9 


MenuEntry is disabled 

1- disableMenuEntry ( ' 01 ' ) . 

2- changeMenuEntry () with parameters: 

Id = '01' 

MenuEntry = "EnableEntry " 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentifier = 

3- isEventSet (EVENT_MENU_SELECTION) . 

4- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1- No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall return true. 

4- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List Simple TLV 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


MenuEntry is null 








changeMenuEntry ( ) with ; 
MenuEntry = NULL 


Shall throw 
java.lang.NullPointerExceptlon. 




11 


Offset causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 


Shall throw 

Java, lang .Array 1 ndexOutOfBoundsE 

xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






12 


Big Offset causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 
Offset = 255 
Length = 1 
NextAction = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






13 


Offset < causes access outside array bounds 

Id = '01' 








MenuEntry = "Violation" 
Offset = -1 
Length = 1 
NextAction = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 






14 


Length causes access outside array bounds 








Id = '01' 

MenuEntry = "Violation" 

Offset = 


Shall throw 
java.lang.ArraylndexOutOfBoundsE 






Length = MenuEntry . length + 1 


xception. 






NextAction = 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 0. 






15 


Length < causes access outside array 
bounds 

Id = '01' 








MenuEntry = "Violation" 


Shall throw 






Offset = 
Length = -1 
NextAction = 


java.lang.ArraylndexOutOfBoundsE 
xception. 






HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 0. 






16 


Both offset and length causes access outside 
array bounds 








Id = '01' 

MenuEntry = "Violation" 


Shall throw 






Offset G [1, MenuEntry . length] 


java.lang.ArraylndexOutOfBoundsE 






Length = MenuEntry . length 


xception. 






NextAction = 1 








HelpSupported = false 








IconQualif ier = 








Iconldentif ier = 







£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



235 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


17 


Invalid ID used 

Id = '00' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID isn't allocated to a menu entry of this applet 
instance 

Id = 'OA' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 
MENU_ENTRY_NOT_FOUND. 




19 


The text is bigger than the allocated space 

Id = '02' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length > 15 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 
ALLOWED_LENGTH_EXCEEDED. 




20 


With a smaller text length than the initial length 

1. changeMenuEntry ( ) with parameters: 

Id = '02' 

MenuEntry = "Init" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2. isEventSet (EVENT_MENU_SELECTION) 

3. 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 



6.2.9.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,6,8,9,20 


N2 


9 


N3 


1,2,3,4,6,8,9,20 


N4 


6 


N5 


7,5 


N6 


6 


N7 


1,2,3,4,8,9,20 


N8 


To be checked in framework tests and insert cross reference here 


N9 


8,9 


N10 


8 


N11 


4 


P1 


10 


P2 


11, 12, 13 


P3 


14, 15 


P4 


16 
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CRR number 


Test case number 


CI 


17, 18 


C2 


19 



6.2.9.3 Method clearEvent 

Test Area Reference: API_2_TKR_CEVTB 

6.2.9.3.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (byte event) 

throws ToolkitException 

6.2.9.3.1.1 Normal execution 

• CRRNl: A call to isEventSet() method for a cleared event should return false after a call to clearEvent. 

• CRRN2:The SIM Toolkit Framework shall not trigger the applet on the occurrence of the cleared event anymore. 

• CRRN3: if event was EVENT_CALL_CONTROL_B Y_SIM and after the call, no applet is registered to it. The 
SIM Toolkit Framework shall allow an applet to register to this event. 

• CRRN4: if event was EVENT_CALL_CONTROL_B Y_SIM and one applet is still registered to these event. The 
SIM Toolkit Framework shall not allow an applet to register to this event. 

• CRRN5: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM and after the call, no applet is 
registered to it. The SIM Toolkit Framework shall allow an applet to register to this event. 

• CRRN6: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM and one applet is still 
registered to these event. The SIM Toolkit Framework shall not allow an applet to set this event. 

6.2.9.3.1 .2 Parameters error 

• CRRP 1 : Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION. 

• CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP3: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_TIMER_EXPIRATION. 

• CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_STATUS_COMMAND. 

6.2.9.3.1.3 Context errors 
No requirements. 

6.2.9.3.2 Test suite files 

Test Script: API_2_TKR_CEVTB_l.scr 

Test Applet: API_2_TKR_CEVTB_l.java 

• As default but applet registers to an event list which contains all defined events in 3GPP TS 43.019 [7] 
excepted those that are not allowed or supported by setEvent(). 

Load Script: API_2_TKR_CEVTB_l.ldr 
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Cleanup script: 
Parameter File: 

6.2.9.3.3 



API_2_TKR_CEVTB_1 .clr 
API_2_TKR_CEVTB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear ALLOWED unregistered events 

For events ranging from 1 to 127 excepted 
those that aren't allowed 
(EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND) , 
the applet calls: 

1- clearEventO method 

2- isEventSetO method 


1- No exception is thrown each 
time. 

2- Shall return false each time. 




2 


Clear registered events 

1- For each ALLOWED and SUPPORTED events, 
the applet calls setEventO method. 

2- For events ranging from 1 to 127 
excepted those that aren't allowed, the 
applet calls: 

2.1- ClearEventO method 

2.2- isEventSetO method 


1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 




3 


Clearing NOT ALLOWED events 

For each event among: 
EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP„REQUEST, 
EVENT_T IMER_EXP IRAT I ON , 

EVENT_STATUS_COMMAND 

1- The applet calls clearEvent (event) 
method. 


1- Each time, clearEvent shall 
throw a Toolkit Exception with 
reason EVENT_NOT_ALLOWED. 




4 


Checking applet isn't triggered by an 
ENVELOPE(SMS-PP DOWNLOAD) command 

1 - reset and initialize the card 

2 - An ENVELOPE (SMS-PP DOWNLOAD) is sent 
with a TAR referencing applet. 


Applet is not trigged by an 
ENVELOPE(SMS-PP 
DOWNLOAD) command 





6.2.9.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


4 


N3 


Framework 


N4 


Framework 


N5 


Framework 


N6 


Framework 


P1 


3 


P2 


3 


P3 


3 


P4 


3 
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6.2.9.4 Method disableMenu Entry 

Test Area Reference: API_2_TKR_DMETB 

6.2.9.4.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 
throws ToolkitException 

6.2.9.4.1.1 Normal execution 

• CRRNl : A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to disableMenuEntryO method. 

• CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to disableMenuEntryO method. 

• CRRN3: After invocation of this method the SIM Toolkit Framework shall dynamically update the menu stored 
in the ME . 

• CRRN4: After invocation of this method, if there is no more enabled menu entries then the SIM Toolkit 
framework shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV with a 
length of zero and no value part. 

6.2.9.4.1.2 Parameters error 
No requirements. 

6.2.9.4.1.3 Context errors 

• CRRCl : shall throw a ToolkitException with reason = ENTRY_NOT_FOUND if the menu entry doesn't exist 
for this applet 

6.2.9.4.2 Test suite files 
Additional requirements for the GSM personalization: 

content of EF sume shall be: 

• Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_DMETB_l.scr 
Test Applet: API_2_TKR_DMETB_l.java 

• Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_DMETB_l.ldr 

Cleanup script: API_2_TKR_DMETB_l.clr 

Parameter File: API_2_TKR_DMETB_1 .par 
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6.2.9.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialize the card 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- Shall return true 

2- Shall return false 


1 - The SIM shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 

disabling a previously enabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry ( ' 01 ' ) 

2- IsEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


3 


Check the menu before 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


2- Shall return true 

3- Shall return true 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 

disabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- disableMenuEntry ('02' ) 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with 1st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to ' FF ' except 
'01' and '02', the applet calls 
disableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





6.2.9.4.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


2,4 


N4 


4 


CI 


5 



6.2.9.5 Method enableMenuEntry 

Test Area Reference: API 2 TKR EMETB 
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6.2.9.5.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 
throws ToolkitException 

6.2.9.5.1.1 Normal execution 

• CRRNl : A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to enableMenuEntryO method. 

• CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to enableMenuEntryO method. 

• CRRN3:The SIM Toolkit Framework shall dynamically issue a SETUP MENU proactive command which does 
contain an ITEM SIMPLE TLV object for this entry. 

6.2.9.5.1.2 Parameters error 
No requirements. 

6.2.9.5.1.3 Context errors 

• CRRCl : shall throw a ToolkitException with reason = MENU_ENTRY_NOT_FOUND if the menu entry 
doesn't exist for this applet 

6.2.9.5.2 Test suite files 
Additional requirements for the GSM personalization: 

content of EF sume shall be: 

• Title Alpha Identifier: "TOOLKIT TEST" 
Test Script: API_2_TKR_EMETB_l.scr 
Test Applet: API_2_TKR_EMETB_l.java 

• Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

Position / Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_EMETB_l.ldr 

Cleanup script: API_2_TKR_EMETB_l.clr 

Parameter File: API_2_TKR_EMETB_1 .par 
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6.2.9.5.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check menu state before 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 


1- 


Shall return true 






1- isEventSet (EVENT_MENU_SELECTION) 
2- 

isEventSet (EVENT MENU SELECTION HELP R 


2- 


Shall return false 


3- The SIIVI shall issue a 




3- 


No exception shall be thrown. 


SET UP MENU proactive 




EQUEST) 






command with entry '02' 




3- disableMenuEntry ('01' ) 






only. 


2 


Check menu state after 

enabling a previously disabled entry 

not registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 










1- enableMenuEntry ( ' 01 ' ) 


1- 


No exception shall be thrown. 


3- The SIM shall issue a 




2- isEventSet (EVENT_MENU_SELECTION) 
3- 


2- 


Shall return true. 


SET UP MENU proactive 




isEventSet (EVENT_MENU_SELECTION_HELP_R 


3- 


Shall return false. 


command with entry '01' 




EQUEST) 






and '02'. 


3 


Check menu state before 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 






4- The SIM shall issue a 




2- isEventSet (EVENT_MENU_SELECTION) 
3- 


2- 


Shall return true 


SET UP MENU proactive 




isEventSet (EVENT MENU SELECTION HELP R 


3- 


Shall return true 


command with entry '01'. 




EQUEST) 


4- 


No exception shall be thrown 


The help information 




4- disableMenuEntry ('02' ) 






available flag. is not verified 


4 


Check menu state after 

enabling a previously enabled entry 

registered to 

EVENT_MENU_SELECTION_HELP_REQUEST 






3- The SIM shall issue a 




1- enableMenuEntry (' 02 ') . 

2- IsEventSet (EVENT_MENU_SELECTION) 
3 


1- 
2- 


No exception shall be thrown. 
Shall return true. 


SET UP MENU proactive 
command with entries '01' 




IsEventSet (EVENT_MENU„SELECTION_HELP_R 


3- 


Shall return true. 


and '02' indicating help 




EQUEST) 






supported. 


5 


Enabling invalid entries 










For ID ranging from '00' to ' FF ' except 


Each time a Toolkit Exception witli 






'01' and '02', the applet calls 


MENU ENTRY NOT FOUND 






enableMenuEntry (ID) method. 




— — — 








reason coae snaii oe tnrown. 





6.2.9.5.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


N3 


1,2,3,4 


C1 


5 



6.2.9.6 Method getEntry 

Test Area Reference: API_2_TKR_GETY 
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6.2.9.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntryO 
throws ToolkitException 

6.2.9.6.1.1 Normal execution 

• CRRNl : returns a reference to the applet ToolkitRegistry object of the calling applet. 

• CRRN2; Each successive call to getEntryO method shall return the same object. 



6.2.9.6.1.2 

No requirements. 

6.2.9.6.1.3 

No requirements. 

6.2.9.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.9.6.3 



Parameters error 

Context errors 

Test suite files 

API_2_TKR_GETY_1 .scr 
API_2_TKR_GETY_1 .Java 
API_2_TKR_GETY_1 .Mr 
API_2_TKR_GETY_1 .clr 
API_2_TKR_GETY_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Installalation 

In the constructor, the applet instance 
calls the getEntryO method. 


Returns a not null ToolkitRegistry 
instance. 




2 


Check it returns the same entry 

The applet calls the getEntryO method 
again . 


Returns the same ToolkitRegistry 
instance as for test case 1 . 





6.2.9.6.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



6.2.9.7 Method getPolllnterval 

Test Area Reference: API_2_TKR_GP0L 

6.2.9.7.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getPolllnterval ( ) 
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6.2.9.7.1.1 



Normal execution 



• CRRNl : shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND 
event. 

• CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT_STATUS_COMMAND event. 



6.2.9.7.1.2 

No requirements. 

6.2.9.7.1.3 

No requirements. 

6.2.9.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.9.7.3 



Parameters error 

Context errors 

Test suite files 

API_2_TKR_GPOL_l .scr 
API_2_TKR_GP0L_1 .Java 
API_2_TKR_GPOL_l .Idr 
API_2_TKR_GPOL_l .clr 
API_2_TKR_GPOL_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet isn't registered to 
EVENT_STATUS_COMMAND 

getPollInterval . 


Shall return 0. 




2 


Requesting max duration 

1- requestPollInterval (15300) 

2- Reset and initialize the card 

3- getPollInterval {) 


1- No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

1- 

requestPoll Interval (POLL_SYSTEM_DURATI 
ON) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 




4 


Requesting no Duration 

1- requestPollInterval (POLL_NO_DURATION) 

2- Reset and initialize the card 

3- getPollInterval {) . 


1 - No exception shall be thrown. 
3- Shall return 0. 
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6.2.9.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


N2 


1,4 



6.2.9.8 Method initMenuEntry 

Test Area Reference: API_2_TKR_IMET_BSSBZBS 

6.2.9.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte initMenuEntry (byte [ ] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte iconQualif ier, 
short iconldentif ier) 
throws Java. lang.NullPointerException, 

Java. lang. Array IndexOutOfBoundsExcept ion. 
Toolkit Except ion 

6.2.9.8.1.1 Normal execution 

• CRRNl: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a 
SETUP MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit 
Framework shall use the data of the EF sume file in order to build the SET UP MENU command. 

• CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the T' successful 
call (without an exception). 

• CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true . 

• CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

• CRRN5: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU conmiand with 
command qualifier = '80' 

• CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

• CRRN7: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 
provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

• CRRN8: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

• CRRN9: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to 0. 

• CRRN 10: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the SIM for this identifier, then the SIM Toolkit framework shall trigger the applet. 

6.2.9.8.1 .2 Parameters error 

• CRRPl : Shall throw java.lang.NullPointerException - if menuEntry is null 
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• CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds 

• CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds 

• CRRP4:Shall throwjava.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds 



6.2.9.8.1.3 



Context errors 



• CRRC 1 : Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space 

• CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialized (eg no more item data in 
applet loading parameter) 

6.2.9.8.2 Test suite files 

Additional requirements for the GSM personalization: 
content of EF sume shall be: 

• Title Alpha Identifier: "TOOLKIT TEST" 

• Test case trigger: 

1- Applet instantiation 

2- Menu selection 

3- Menu selection Help Supported 

Test Script: API_2_TKR_IMET_BSSBZBS_l.scr 

Test Applet: API_2_TKR_IMET_BSSBZBS_l.java 

• Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 
Maximum number of menu entries: 6 

- Position / Identifier for each menu entry: '017'01', '027'02', '037'03', '04704', '05'/'05', and '06'/'06' 
Load Script: API_2_TKR_IMET_BSSBZBS_Lldr 

Cleanup script: API_2_TKR_IMET_BSSBZBS_Lclr 

Parameter File: API_2_TKR_IMET_BSSBZBS_1 .par 



6.2.9.8.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

MenuEntry = NULL 


Shall throw a 
java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

MenuEntry = "ToolkitTest " 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Offset < 

MenuEntry = "ToolkitTest" 
Offset = -1 
Length =11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




4 


Offset = 255 

MenuEntry = "ToolkitTest" 
Offset = 255 
Length =11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




5 


Length = menuEntry.length+1 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




6 


Length < 

MenuEntry = "ToolkitTest" 
Offset = 
Length = -1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




7 


Offset + length > menuEntry.length 

MenuEntry = "ToolkitTest" 
Offset = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 

xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

MenuEntry = "ToolkitTest impossible" 
Offset = 
Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- InitMenuEntry 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) 


1 - No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- InitMenuEntry ( ) 

MenuEntry = " 1234567TOOLKIT TEST 2" 

Offset = 7 

Length =14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be 
thrown, Shall return ID '02'. 

2- Shall return false. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call, 
menuEntry with help supported 

1- InitMenuEntry 

MenuEntry = "TOOLKIT TEST 3" 
Offset = 
Length = 14 
NextAction = '00' 
HelpSupported = true 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be thrown, 
Shall return ID '03' 

2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

MenuEntry = "TOOLKIT TEST 4" 

Offset = 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1- No exception shall be thrown. 

2- Shall return ID '04' 




13 


Successful call, 
menuEntry with a next action indication 

MenuEntry = "TOOLKIT TEST 5" 

Offset = 

Length = 14 

NextAction = '24' [Select Item] 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


1 - No exception shall be thrown. 
2- Shall return ID '05' 




14 


Successful call, 
length = 

InitMenuEntry ( ) 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown, Shall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

MenuEntry = "ToolkitTest" 
Offset = 
Length =11 


REGISTRY_ERROR 
ToolkitException is thrown. 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



248 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API Expectation 


APDU Expectation 


16 


Dynamic update of the menu stored by the me 

Fetch 




Card shall Send a 

SetUpMenu Proactive 

command: 

[GommandOualifier]=help 

supported 

[Alphald]="TOOLKIT TEST" 

[ltemld=1] = "TOOLKIT 

TEST 1 " 

[ltemld=2] = "TOOLKIT 

TEST 2" 

[ltemld=3] = "TOOLKIT 

TEST 3" 

[ltemld=4] = "TOOLKIT 

TEST 4" 

[ltemld=5] = "TOOLKIT 

TEST 5" 

[ltemld=6] = "" 

[ltemsNextAction]=0600000 

0002400 


17 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '01' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '01' 




18 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '02' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '04' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '05' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 




22 


Check Applet is triggered by ENVELOPE 
(MENU_SELEGTION_HELP_REQUEST) 
command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU SELECTION 
HELP_REQUEST) command & 
Menu Entry ID = '03' 




23 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 





6.2.9.8.4 



Test Coverage 



CRR number 


Test case number 


N1 


16 


N2 


9 


N3 


11 
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CRR number 


Test case number 


N4 


22 


N5 


11, 16 


N6 


10 


N7 


12,16 


N8 


12,16 


N9 


13,16 


N10 


9, 10, 11, 12, 13, 14, 17, 18, 19,20,21,23 


P1 


1 


P2 


2,3,4 


P3 


5,6 


P4 


7 


C1 


8 


C2 


14 



6.2.9.9 Method isEventSet 

Test Area Reference: API_2_TKR_IEVSB 

6.2.9.9.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet (byte event) 

6.2.9.9.1.1 Normal execution 

• CRRNl: shall return true if the event is set in the Toolkit Registry for the applet. 

• CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet. 

6.2.9.9.1 .2 Parameters error 
No requirements. 

6.2.9.9.1.3 Context errors 
No requirements. 

6.2.9.9.2 Test suite files 

Test Script: API_2_TKR_IEVSB_l.scr 

Test Applet: API_2_TKR_IEVSB_l.java 

• Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 1 
Position / Identifier for each menu entry: 'Ol'/'Ol' 

- Maximum number of timers: 1 
Load Script: API_2_TKR_IEVSB_l.ldr 
Cleanup script: API_2_TKR_IEVSB_l.clr 
Parameter File: API_2_TKR_IEVSB_1 .par 
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6.2.9.9.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Events aren't set 

Applet calls isEventSetO for each events 
ranging from 1 to 127 excepted 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_MENU_SELECTION . 


Shall return false each time. 




2 


For EVENT_FORMATTED_SMS_PP_ENV 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


Shall return true. 




3 


For EVENT_MENU_SELECTION 

IsEventSet (EVENT_MEND_SELECTION) 


Shall return true 




4 


After clearing 
EVENT_FORMATTED_SMS_PP_ENV 

1- clearEvent {EVENT_FORMATTED_SMS_PP_ENV) 

2- 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Setting events 

1- For each SUPPORTED and ALLOWED events 
for setEventO, applet calls: 

1.1- setEventO method 

1.2- IsEventSet method. 


1.1- No exception shall be 
thrown. 

1 .2- Shall return true each time. 




6 


For 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- IsEventSet 
(EVENT_MENU_SELECTION_HELP_REQUEST) 

2- call changeMenuEntry with help 
supported 

3- IsEventSet 
(EVENT_MENU_SELECTION_HELP_REQUEST) 


1- Shall return false. 
3- Shall return true 




7 


For EVENT_TIMER_EXPIRATION 

1- IsEventSet (EVENT_TIMER_EXPIRATION) 

2- call allocateTimer 

3- IsEventSet (EVENT_TIMER_EXPIRATION) 


1- Shall return false. 
3- Shall return true 




8 


For EVENT_STATUS_COMMAND 

1- IsEventSet (EVENT_STATUS_COMMAND) 

2- call 

requestPollInterval (POLL_SYSTEM_DURATION) 

3- IsEventSet (EVENT_STATUS_COMMAND) 


1- Shall return false. 
3- Shall return true 





6.2.9.9.4 



Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7, 8 


N2 


1,5,6,7,8 
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6.2.9.10.1.1 



Normal execution 



• CRRNl: if it was the last allocated timer for the applet then a following call to isEventSet() method for 
EVENT_TIMER_EXPIRATION should return false. 

• CRRN2: if applet has timers allocated then a call to isEventSet(EVENT_TIMER_EXPIRATION) shall return 
true. 

• CRRN3: After invocation of the method the indicated timer shall be released and available for reallocation. 

• CRRN4: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

6.2.9.1 0.1 .2 Parameters error 

• CRRPl: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer identifier isn't between 1 
and 8. 



6.2.9.10.1.3 



Context errors 



CRRCl: shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is valid but isn't 
allocated to this applet. 



6.2.9.10.2 
Test Script: 
Test Applet: 



Test suite files 

API_2_TKR_RTIMB_1 .scr 
API_2_TKR_RTIMB_1 .Java 



• Installation parameter: 

As Default, except max timer which is set to 8. 
Load Script: API_2_TKR_RTIMB_l.ldr 

Cleanup script: API_2_TKR_RTIMB_l.clr 

Parameter File: API_2_TKR_RTIMB_1 .par 



6.2.9.10.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Releasing not allocated timers 

For each timer ID ranging from '00' to 
' FF ' , applet calls releaseTimer (ID) . 


Each time, method shall throw a 
ToolkitException with reason code 
INVALID_TIMER_ID. 




2 


Releasing allocated timers 

1- 8 * allocateTimer . 

2- 7 * releaseTimer (id) . 

3- isEventSet (EVENT_TIMER_EXPIRATION) 


1- No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Releasing invalid tinier ID 

1- releaseTimer ( ' FF ' ) method 

2- isEventSet {EVENT_TIMER_EXPIRATION) 


1 - Shall throw a ToolkitException 
with INVALID_TIMER_ID reason 
code. 

2- Shall return true. 




4 


Releasing last timer 

1- releaseTimer (last timer allocated) 

2- isEventSet (EVENT_TIMER_EXPIRATION) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Checking we can allocate timers after they 

have been released 
8 * allocateTimer . 


No exception shall be thrown. 




6 


Releasing all timers. 

For 1 to 8, releaseTimer (id) . 


No exception shall be thrown. 




7 


Checking applet isn't triggered by 

ENVELOPE (TIMER_EXPIRATION) command 
Send ENVELOPE (TIMER_EXPIRATION) 


Applet is not trigged by an 

ENVELOPE(TIMER_EXPIRATION) 

command 





6.2.9.10.4 



Test Coverage 



CRR number 


Test case number 


N1 


4 


N2 


2,3 


N3 


5,6 


N4 


7 


PI 


1,3 


CI 


Framework 



6.2.9.11 Method requestPolllnterval 

Test Area Reference: API_2_TKR_RPOLS 

6.2.9.1 1 .1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public void requestPolllnterval (short duration) 
throws ToolkitException 



6.2.9.11.1.1 



Normal execution 



CRRNl: If duration is between 1 and 15300 or equal to POLL_SYSTEM_DURATION, the applet registers to 
EVENT_STATUS_COMMAND. 

CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from 
EVENT_STATUS_COMMAND. 



6.2.9.11.1.2 



Parameters error 



• CRRPl : the method should throw a ToolkitException with REGISTRY_ERROR reason if duration is > 15300 
oris < -1 (POLL_SYSTEM_DURATION). 
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6.2.9.11.1.3 
No requirements. 

6.2.9.11.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.9.11.3 



Context errors 

Test suite files 

API_2_TKR_RP0LS_1 .scr 
API_2_TKR_RP0LS_1 .Java 
API_2_TKR_RPOLS_l .Mr 
API_2_TKR_RPOLS_l .clr 
API_2_TKR_RPOLS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Requesting a value between 1 and 15300 s 

1- isEventSet (EVENT_STATUS_COMMMAND) 

2- requestPollInterval (duration) for 
boundaries values: 1, 255, 256, 15300. 

3- isEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




3 


Requesting POLL SYSTEM DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND) . 

2- 

RequestPoll Interval (POLL_SYSTEM_DURATI 
ON) . 

3- IsEventSet (EVENT„STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




5 


Requesting invalid duration 

requestPolllnterval(duration) for following values: 
15301,32767,-2,-32768 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 




6 


Requesting POLL NO DURATION 

1- isEventSet (EVENT_STATUS„COMMMAND) 

2- requestPollInterval (POLL_NO_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 




7 


Check Applet isn't triggered by an STATUS 
command. 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is not trigged by a 
STATUS command 
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6.2.9.11.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


6,7 


PI 


5 



6.2.9.12 Method setEvent 

Test Area Reference: API_2_TKR_SEVTB 

6.2.9.12.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public void setEvent (byte id) 

throws ToolkitException 

6.2.9.12.1.1 Normal execution 

• CRRNl: a following call to isEventSet() method with the same event id shall answer true for the applet. 

• CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of the set event happens. 

• CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND 

6.2.9.12.1.2 Parameters error 

• CRRP 1 : shall throw a ToolkitException with E VENT_NOT_SUPPORTED reason if event is 0. 

• CRRP2: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION. 

• CRRP3: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP4: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT_TIMER_EXPIRATION. 

• CRRP5: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if event is 
EVENT STATUS COMMAND. 



6.2.9.12.1.3 



Context errors 



• CRRC 1 : shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

• CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 
EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM but another applet is already registered to it. 

6.2.9.12.2 Test suite files 

Test Script: API_2_TKR_SEVTB_l.scr 

Test Applet: API_2_TKR_SEVTB_l.java 

API_2_TKR_SEVTB_2.java 
Load Script: API_2_TKR_SEVTB_l.ldr 

The load script installs the 2 instances. 
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Cleanup script: 
Parameter File: 

6.2.9.12.3 



API_2_TKR_SEVTB_1 .clr 
API_2_TKR_SEVTB_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Appletl is triggered by ENVELOPE(SMS 
PP_FORMATTED) command. 

Send ENVELOPE (SMS_PP_FORMATTED) 


Appletl shall be triggered 




2 


Setting ALLOWED and SUPPORTED events 

1- For all events defined in GSM 0319 
(from 1 to 19) and allowed: 
EVENT_PROFILE_DOWNLOAD, 
EVENT_FORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD, 
EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_UNFORMATTED_SMS_PP_UPD, 
EVENT_FORMATTED_SMS_CB, 
EVENT_UNFORMATTED_SMS_CB , 
EVENT CALL CONTROL BY SIM, 








EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 


1.1- No exception shall be thrown. 






EVENT_EVENT_DOWNLOAD_MT_CALL , 








EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 


1 .2- Shall return false. 






EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 








EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 


1 .3- No exception shall be thrown. 






EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABL 








E, 


1 .4- Shall return true. 






EVENT EVENT DOWNLOAD CARD READER STATUS 








EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 


1 .5- No exception shall be thrown. 






EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION. 








1.1- clearEvent (event ) 








1.2- isEventSet (event) 








1.3- setEvent (event) 








1.4- isEventSet (event) 








1.5- clearEvent (event ) 






3 


Event 


Shall throw a ToolkitException with 






Call setEvent (0) 


EVENT_NOT_SUPPORTED reason 
code. 




4 


Setting EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 






Call setEvent (EVENT_MENU_SELECTION) 


EVENT_NOT_ALLOWED reason 
code. 




5 


Setting 








EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
EVENT NOT ALLOWED reason 






Call 

setEvent (EVENT_MENU_SELECTION_HELP_REQUES 

T) 


code. 




6 


Setting EVENT_TIMER_EXPIRATION 


Shall throw a ToolkitException with 






Call setEvent (EVENT_TIMER_EXPIRATION) 


EVENT_NOT_ALLOWED reason 
code. 




7 


Setting EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 






Call setEvent (EVENT_STATUS_COMMAND) 


EVENT_NOT_ALLOWED reason 
code. 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Setting EVENT_CALL_CONTROL_BY_SIIVI 

Call setEvent (EVENT_CALL_CONTROL_BY_SIM) 


No Exception shall be thrown 




9 


Setting 

EVENT MO SHORT MESSAGE CONTROL B 

Y_SIM 

Call 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM) 


No Exception shall be thrown 




10 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE{CALL CONTROL BY 
SIM) 




11 


Check applet is triggered by an 

ENVELOPE(MO SHORT MESSAGE CONTRO 

L_BY_SIM) 

Trigger the Applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSAG 
E_GONTROL_BY_SIM) 




12 


Applet 2 is triggered by ENVELOPE(SMS 
PP_DOWNLOAD) command. 

Trigger the applet 2 


Applet 2 is trigged by an 

ENVELOPE(SMS 

PR DOWNLOAD) command 




13 


Applet 2 registers to 
CALL_CONTROL_BY_SIM 
but it is already assigned 

setEvent (EVENT_CALL_CONTROL_BY_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet 2 registers to 

MO_MESSAGE_CONTROL_BY SIM 

but it is already assigned 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.12.4 



Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


1, 8, 9, 10, 11, 12 


N3 


2, 4, 5, 6, 7 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


CI 


13 


C2 


14 



6.2.9.13 Method setEventList 

Test Area Reference: API 2 TKR SEVL BSS 



6.2.9.13.1 



Conformance Requirement: 



The method with following header shall be compliant to its definition in the API. 

public void setEventList (byte [ ] eventList, 

short offset, 
short length) 
throws Java . lang . NullPointerException, 

Java .lang . Array I ndexOut Of Bounds Except ion, 
ToolkitException 

6.2.9.13.1.1 Normal execution 

• CRRNl: for all events set successfully by this method, a call to isEventSet() method should return true. 
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• CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of one of the successfully 
registered events happens. 

• CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST, EVENT_TIMER_EXPIRATION , 
EVENT_STATUS_COMMAND. 

6.2.9.1 3.1 .2 Parameters error 

• CRRPl: shall throw a java.lang.NullPointerException if eventList is null. 

• CRRP2: shall throw a java.lang.ArraylndexOutOfBoundsException if offset would cause access outside array 
bounds. 

• CRRP3: shall throw a java.lang. ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

• CRRP4: shall throw a java.lang. ArraylndexOutOfBoundsException if both offset and length would cause access 
outside array bounds. 

• CRRP5: shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

• CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION. 

• CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

• CRRP9: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

6.2.9.13.1.3 Context errors 

• CRRC 1 : shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

• CRRC2: shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if eventList contains 
EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM but another applet is already registered to it. 

6.2.9.13.2 Test suite files 

Test Script: API_2_TKR_SEVL_BSS_Lscr 

Test Applet: API_2_TKR_SEVL_BSS_l.java 

API_2_TKR_SEVL_BSS_2.java 
Load Script: API_2_TKR_SEVL_BSS_Lldr 

The load script installs the 2 instances. 
Cleanup script: API_2_TKR_SEVL_BSS_Lclr 

Parameter File: API_2_TKR_SEVL_BSS_1 .par 
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6.2.9.13.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet 1 Registering all eventList buffer 

EventList = all allowed events defined in 
GSM 0319: 

EVENT_PROF I LE_DOWNLOAD , 
EVENT_FORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD , 
EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_UNFORMATTED_SMS_PP_UPD , 
EVENT_FORMATTED_SMS_CB , 
EVENT_UNFORMATTED_SMS_CB , 
EVENT_CALL_CONTROL_B Y_S IM, 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 
EVENT_EVENT_DOWNLOAD_MT_CALL, 








EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 


1 - No exception shall be thrown. 






EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 


2- No exception shall be thrown. 






EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 








, EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


3- Each time shall return true. 






EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 








EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION. 


4- No exception shall be thrown. 






1- For each event in EventList 








clearEvent (event) 








2- setEventList (eventList ) 








Offset = 








Length = eventList . lentgh 








3- For all events in eventList 








isEventSet (event) 








4- For each event in EventList 








clearEvent (event) 






2 


Registering part of eventList buffer 

EventList = all allowed events defined in 
GSM 0319 (see test case 1) . 








1- For each event in EventList 


1 - No exception shall be thrown. 






clearEvent (event) 








2- setEventList (eventList, offset, 
length) 


2- No exception shall be thrown. 






Offset > 

Length = eventList . lentgh - offset 


3- Each time shall return true for 






events ranging from offset to 
offset+length else shall return false. 






3- For all events in eventList: 








isEventSet (event) 


4- No exception shall be thrown. 






4- For each event in EventList: 








clearEvent (event) 






3 


Null buffer 


Shall throw a 






EventList = null 


java.lang.NullPointerException 
Exception 




4 


Out of bounds offset 


Shall throw a 






Offset = eventList . length 
Length = 1 


java.lang.ArraylndexOutOfBounds 
Exception 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Out of bounds and big offset 

Offset = 255 
Length = 1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




6 


Offset < 

Offset = -1 
Length = 1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




7 


Out of bounds length 

Offset = 

Length = eventList . length + 1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




8 


Out of bounds and big length 

Offset = 
Length = 255 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




9 


Length < 

Offset = 
Length = -1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




10 


Out of bounds offset + Length 

Offset + length > eventList . length + 1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 

Exception 




11 


Event 

Call setEventList (eventList ) with 
eventList indicating event 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList) with 
eventList indicating EVENT_MENU_SELECTION 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




13 


EVENT_MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList ) with 
eventList indicating 
EVENT_MENU_SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




14 


EVENT_TIMER_EXPIRATION 

Call setEventList (eventList ) with 
eventList indicating 
EVENT_T IMER_EXP IRAT ION 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList ) with 
eventList indicating EVENT_STATUS_COI«AND 


Shall throw a ToolkitException with 
reason code 
EVENT_NOT_ALLOWED. 




16 


Setting EVENT_CALL_CONTROL_BY_SIM 

setEventList (List, 0, 2) with List 
containing 

EVENT_CALL_CONTROL_BY_SIM & 
EVENT_MO_SHORT„MESSAGE„CONTROL_BY_SIM 


Shall not throw an exception 




17 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Reset and initialize the card 
Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
_SIM) 




18 


Check applet is triggered by an 

ENVELOPE(MO SHORT MESSAGE CONTROL 

_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSA 
GE CONTROL BY SIM) 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Applet 2 registers to CALL_CONTROL_BY_SIM 
but it is already assigned 

setEventList (MonoEventList , 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_B Y_S IM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




20 


Applet 2 registers to 

MO_SHORT_MESSAGE_CONTROL_BY_SIM 

but it is already assigned 

setEventList(MonoEventList,0,1 ) with 

MonoEventList containing 

EVENT MO SHORT MESSAGE CONTROL BY 

_SIM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


16, 17, 18 


N3 


1, 2, 11, 12, 13, 14, 15 


PI 


3 


P2 


4,5,6 


P3 


7,8,9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


C1 


19 


C2 


20 



6.2.10 Class ViewHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EditHandler, EnvelopeHandler, ProactiveResponseHandler, ProactiveHandler. 

6.2.1 1 Class ToolkitException 
6.2.1 1 .1 Exception Constants 

Test Area Reference: API_2_TKE_CONS 

6.2.1 1 .1 .1 Conformance requirement: 

There is no API, only constants. 

6.2.11.1.1.1 Normal execution 

• CRRNl: The Constants of the class ToolkitException shall all have the same name and value defined in the 

3GPPTS 43.019 [7]. 



6.2.11.1.1.2 
No requirements. 



Parameters error 
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6.2.11.1.1.3 


Context errors 


No requirements. 




6.2.11.1.2 


Test suite files 


None. 




6.2.11.1.3 


Test procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.1 1 .2 Constructor ToolkitException 

Test Area Reference: API_2_TKE_COORS 

6.2.1 1 .2.1 Conformance requirement: 

The constructor with following headershall compliant to its definition in the API. 

public ToolkitException (short reason) 

6.2.11.2.1.1 Normal execution 

• CRRNl: Construct a ToolkitException instance with the specified reason. 



6.2.11.2.1.2 
No requirements. 

6.2.11.2.1.3 
No requirements. 

6.2.11.2.2 



Parameters error 



Context errors 



Test suite files 



No additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.11.2.3 



API_2_TKE_COORS_l .scr 
API_2_TKE_COORS_l .Java 
API_2_TKE_COORS_l .Idr 
API_2_TKE_COORS_l .clr 
API_2_TKE_COORS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 19 


ToolkitException. getReasonQ = 
(short)19 





6.2.11.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 
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6.2.11.3 Method throwit 

Test Area Reference: API_2_TKE_THITS 

6.2.1 1 .3.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static void throwit {short reason) 
throws ToolkitException 

6.2.11.3.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of the ToolkitException class with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException 
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6.2.11.3.1.2 
No requirements. 

6.2.11.3.1.3 
No requirements. 

6.2.11.3.2 



Parameters error 



Context errors 



Test suite files 



No additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.11.3.3 



API_2_TKE_THITS_1 . scr 
API_2_TKE_THITS_1 .j ava 
API_2_TKE_THITS_1 .Idr 
API_2_TKE_THITS_1 .clr 
API_2_TKE_THITS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of Tooll<itException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of Tooll<itException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 5 




4 


Tooll<itException extends 
javacard.frameworlc.CardRuntimeException 


Reason = 




5 


Tooll<itException extends 
javacard.frameworlc.CardRuntimeException 


Reason = 1 




6 


Tooll^itException extends 
javacard.frameworlcCardRuntimeException 


Reason = 1 5 





6.2.11.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 
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6.3 SIM Toolkit Framework 
6.3.1 Minimum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

6.3.1.1 ProactiveHandler 

Test Area Reference: FWK_MHA_PAHD 

6.3.1.1.1 Conformance Requirement 

6.3.1.1.1.1 Normal Execution 

• CRRNl: If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 

6.3.1.1.1.2 Parameters error 
No requirements. 
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6.3.1.1.1.3 

No requirements. 

6.3.1.1.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

Test Procedure 



Context errors 

Test Suite Files 

FWK_MHA_PAHD_1 .scr 
FWK_MHA_PAHD_1 .Java 
FWK_MHA_P AHD_2.j ava 
FWK_MHA_PAHD_1 .Idr 
FWK_MHA_PAHD_1 .clr 
FWK_MHA_PAHD_1 .par 



Id 



Description 



API /Framework Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Handler availability with 

EVENT_PROFILE_DOWNLOAD 

Appletl is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry () for 
EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 
setEventList () for the rest of the 
events . 

Applet2 is registered to all events 
defined in [7], except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Using the methods initMenuEntry () for 
EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 
setEventList () for the rest of the 
events . 

The priority of appletl is higher than 
priority of applet2 

1-Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST, 
POLL_INTERVAL, SET UP IDLE MODE TEXT and 
SET UP MENU. 

2-Appletl gets the Proactive Handler 
Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 



3-Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT_PROF I LE_DOWNLOAD 



1- Appletl is triggered 

2- No exception is thrown. 

3- Applet2 is triggered 

4- No exception is thrown 



Appletl finalizes 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



265 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API /Framework Expectation 


APDU Expectation 


2 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1-Envelope menu selection with help 
request is sent to the SIM 

2-Appletl gets the Proactive Handler 

3-Envelope menu selection with help 
request is sent to the SIM 

4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is tlirown 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

l-Envelope menu selection is sent to the 

SIM 

2-Appletl gets the Proactive Handler 

3-Envelope menu selection is sent to the 
SIM 

4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




4 


Proactive Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad formatted is sent 
to the SIM 

2-Appletl gets the Proactive Handler 

3-Envelope dataDownLoad formatted is sent 
to the SIM 

4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Proactive Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-Envelope dataDownLoad unformatted is 
sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


6 


Proactive Handler availability with 
EVENT_FORMATTED_CELL BROADCAST 

l-Envelope cell broadcast formatted is 
sent to the SIM 

2-Appletl gets the Proactive Handler 

3-Envelope cell broadcast formatted is 
sent to the SIM 

4-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2-No exception is thrown 

Appletl finalizes 
3-Applet2 is triggered 

4-No exception Is thrown 




7 


Proactive Handler availability with 
EVENT_UNFORMATTED_CELL BROADCAST 

l-Envelope cell broadcast unformatted is 
sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




8 


Proactive Handler availability with 
EVENT_TIMER_EXPIRATION 

l-Timer Id =1 

Envelope Timer Expiration is sent to the 

SIM 

2-Appletl gets the Proactive Handler 

3-Timer id=2 

Envelope Timer Expiration is sent to the 

SIM 

4- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




9 


Proactive Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by SIM is sent to 
the SIM 

2-Appletl gets the Proactive Handler 


1- Appletl is triggered 
2- No exception is thrown . 




10 


Proactive Handler availability with 
EVENT_MO_SHORT_MESSAGE_CONTROL 

l-Envelope mo short message control by SIM 
is sent to the SIM 

2-Appletl gets the Proactive Handler 


1- Appletl is triggered 
2- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




12 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

l-Envelope event download call connected 
is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




13 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

l-Envelope event download call 
disconnected is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




14 


Applets triggering with 
EVENT_EVENT_LOCATION_STATUS 

l-Envelope event download location status 
is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


15 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

l-Envelope event download user activity is 
sent to SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




16 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

l-Envelope event download idle screen 
available is sent to the SIM 

2-Appletl gets the Proactive Handler 
3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




17 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

l-Envelope event download card reader 
status is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




18 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE SE 

LECTION 

l-Envelope event download language 
selection is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2-No exception is thrown. 

Appletl finalizes 
Applet2 is triggered 

3-No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


19 


Proactive Handler availability with 

EVENT EVENT DOWNLOAD BROWSER TER 

MINATION 

1-Envelope event download browser 
termination is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2-No exception is tlirown. 
Appletl finalizes 
Applet2 is triggered 

3-No exception is thrown 




20 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

l-Status command is sent to the SIM 
2-Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception Is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




21 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

l-An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the SIM 

2-Appletl gets the Proactive Handler 
3-Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 





6.3.1.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19,20,21 



6.3.1.2 ProactiveResponseHandler 

Test Area Reference: FWK MHA PRHD 



6.3.1.2.1 



6.3.1.2.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The ProactiveResponseHandler is available after the first call to the ProactiveHandler.send method to 
the termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 
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EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_A VAIL ABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 



6.3.1.2.1.2 

No requirements. 

6.3.1.2.1.3 

No requirements. 

6.3.1.2.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context errors 

Test Suite Files 

FWK_MHA_PRHD_1 .scr 
FWK_MHA_PRHD_1 .Java 
FWK_MHA_PRHD_2.j ava 
FWK_MHA_PRHD_1 .Idr 
FWK_MHA_PRHD_1 .clr 
FWK_MHA_PRHD_1 .par 
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6.3.1.2.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to all events and Proactive 

Response Handler availability with 

EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 
defined in [7], applet2 is registered to 
all events defined in [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SMS_CONTROL_B Y_S IM . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

1-Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
and POLL_INTERVAL, , SET UP IDLE MODE TEXT 
and SET UP MENU. 

Appletl builds a proactive command DISPLAY 
TEXT. 

2- ProactiveHandler . send ( ) method is 
called 



3- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 



1 -Appletl is triggered 
No exception is thrown 



3- No exception is tlirown 



2- The proactive command 
DISPLAY TEXT is fetched 

TERIVIINAL RESPONSE 



Applet2 builds a proactive command DISPLAY 

TEXT. 

4- ProactiveHandler . send ( ) method is 

called 



5- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 

Appletl is deregistered to EVENT_PROFILE_DOWNLOAD 



Appletl finalizes 



4- Applet2 is triggered 



5- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Proactive Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 








1-Envelope menu selection with help 
request is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2- ProactiveHandler . send method is 
called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3- 

ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is tlirown 






method is called 

Appletl execution is finished 


Appletl finalizes 






Envelope menu selection with help request 








is sent to the SIM 


4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 








4- ProactiveHandler . send method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 


6- No exception is thrown 






ProactiveResponseHandler . getTheHandler ( ) 








method is called 






3 


Proactive Response Handler availability with 
EVENT_MENU_SELECTION 








l-Envelope menu selection is sent to the 

SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2- ProactiveHandler . send method is 
called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 
Appletl finalizes 






4-Envelope menu selection is sent to the 








SIM 


4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 








5- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




6-ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Proactive Response Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 








l-Envelope dataDownLoad formatted is sent 
to the SIM 


1- Appletl is triggered 






Applet builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is tlirown 
Appletl finalizes 


TERMINAL RESPONSE 




4-Envelope dataDownLoad formatted is sent 








to the SIM 


4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 








5-ProactiveHandler . send method is called 




5- A proactive command 
DISPLAY TEXT is fetched 




6-ProactiveResponseHandler . getTheHandler ( ) 




TERMINAL RESPONSE 




method is called 


6- No exception is thrown 




5 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 








l-Envelope dataDownLoad unformatted is 
sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2- ProactiveHandler . send ( ) method is 
called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 


3- No exception Is thrown 
Appletl finalizes 






Applet2 builds a proactive command DISPLAY 








TEXT 

4- ProactiveHandler . send ( ) method is 

called 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 








l-Envelope call broadcast unformatted is 
sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2- ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called. 


3- No exception is tlirown 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 


Appletl finalizes 






TEXT 








4- ProactiveHandler . send ( ) method is 
called 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 




5- 

ProactiveResponseHandler . getTheHandler ( ) 




TERMINAL RESPONSE 










method is called 


6- No exception is thrown 




7 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 








l-Envelope call broadcast unformatted is 
sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2- ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 

method is called. 


3- No exception is thrown 

Appletl finalizes 

4- Applet2 is triggered 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 








TEXT 








4- ProactiveHandler . send method is 

called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception Is thrown 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



275 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


8 


Proactive Response Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 








1-Envelope Timer Expiration is sent to the 

SIM 


1- Appletl is triggered 






Applet builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getlheHandler ( ) 








method is called 


3- No exception is tlirown 






Timer id=2 


Appletl finalizes 






Envelope Timer Expiration is sent to the 








SIM 








Applet builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4-ProactiveHandler . send ( ) method is called 


5- No exception is thrown 






5-ProactiveResponseHandler . getlheHandler ( ) 








method is called 




6- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


9 


Proactive Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by sim is sent to 








the SIM 


1- Appletl is triggered 






Applet builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getlheHandler ( ) 
method is called 


3- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


10 


Proactive Response Handler availability with 
MO_SHORT_IVIESSAGE_CONTROL_BY_SIIVI 








l-Envelope mo short message control by sim 
is sent to the SIM 


1- Appletl is triggered 






Applet builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2- A proactive command 
DISPLAY TEXT is fetched 
TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 




11 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 








l-Envelope event download mt call is sent 
to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called. 


3- No exception is thrown 
Appletl finalizes 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4- ProactiveHandler . send method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 




5- 




TERMINAL RESPONSE 




ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 








l-Envelope event download call connected 
is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 




TERMINAL RESPONSE 




method is called 


3- No exception is thrown 
Appletl finalizes 






Applet builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4- ProactiveHandler . send method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 




13 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 








l-Envelope event download call 
disconnected is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 
Appletl finalizes 






Applet2 builds a proactive command DISPLAY 


4- Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 








called 








5- 




5- A proactive command 
DISPLAY TEXT is fetched 




ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


14 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 








l-Envelope event download location status 
is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is tlirown 

Appletl finalizes 

4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 








4- ProactiveHandler . send method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 


6- No exception is thrown 






method is called 






15 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








l-Envelope event download user activity is 
sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2-A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 
Appletl finalizes 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 


4- Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 








l-Envelope event download idle screen 
available is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 
TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 

Appletl finalizes 

4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 

called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 


6- No exception is thrown 




17 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 








l-Envelope event download language 
selection is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 

TEXT 

2-ProactiveHandler . send method is called 




2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3-No exception is thrown 
Appletl finalizes 






Applet2 builds a proactive command DISPLAY 
TEXT 


Applet2 is triggered 






4- ProactiveHandler . send ( ) method is 
called 








5- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 


5-No exception is thrown 


4-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Proactive Response Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 








l-Envelope event download Browser 
termination is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send method is called 




2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 








method is called 


3-No exception is thrown 
Appletl finalizes 






Applet2 builds a proactive command DISPLAY 


Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 








called 








5- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 


5-No exception is thrown 


4-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


19 


Proactive Response Handler availability with 
EVENT_STATUS_COMMAND 








l-Status command is sent to the SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 






method is called 


Appletl finalizes 






Applet2 builds a proactive command DISPLAY 


4- Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 




5- 




TERMINAL RESPONSE 




ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


20 


Proactive Response Handler availability with 
UNRECOGNIZED_ENVELOPE 








l-An unrecognized Envelope is sent to the 

SIM 


1- Appletl is triggered 






Appletl builds a proactive command DISPLAY 
TEXT 

2-ProactiveHandler . send method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is tlirown 
Appletl finalizes 






Applet2 builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 




4- ProactiveHandler . send method is 
called 




TERMINAL RESPONSE 




5- 








ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 





6.3.1.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19,20 



6.3.1.3 EnvelopeHandler 

Test Area Reference: FWK MHA ENHD 



6.3.1.3.1 



6.3.1.3.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl: The EnvelopeHandler and its content are available for all toolkit applets triggered from the invocation 
to the termination of their processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 
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EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT. 
EVENT. 
EVENT. 
EVENT. 
EVENT. 
EVENT. 

6.3.1.3.1.2 

No requirements. 

6.3.1.3.1.3 



.EVENT_DOWNLOAD_CALL_CONNECTED 

.EVENT_DOWNLOAD_CALL_DISCONNECTED 

.EVENT_DOWNLOAD_LOCATION_STATUS 

.EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

.EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_DOWNLOAD_LANGUAGE_SELECTION 

.EVENT_DOWNLOAD_BROWSER_TERMINATION 

.UNRECOGNIZED_ENVELOPE 

.CALL_CONTROL 

.SMS_MO_CONTROL 

Parameters error 
Context Errors 



CRRCl: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 



6.3.1.3.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite Files 

FWK_MHA_ENHD_1 .scr 
FWK_MHA_ENHD_1 .Java 
FWK_MHA_ENHD_2.j ava 
FWK_MHA_ENHD_1 .Idr 
FWK_MHA_ENHD_1 .clr 
FWK_MHA_ENHD_1 .par 
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6.3.1.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Appletl and Applet2 registration and Envelope 

Handler availability with 

EVENT PROFILE DOWNLOAD 



1- Appletl is registered to all events 
defined [7 ] . 

Using the methods InitMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Applet2 is registered to all events 
defined [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Using the methods InitMenuEntry () for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer for 
EVENT_TIMER_EXPIRATION and setEventList 
for the rest of the events. 

2-Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 
, SETUP_IDLE_MODE_TEXT , POLL_INTERVAL and 
SETUP MENU 



3-EnvelopeHandler . getlheHandler ( ) method 
is called by Appletl 
Appletl is deregistered to 
EVENT„PROFILE_DOWNLOAD 



4-EnvelopeHandler . getlheHandler ( ) method 
is called by Applet2 
Applet2 is deregistered to 
EVENT_PROF I LE_DOWNLOAD 



1- No exception is thrown 



2- Appletl is triggered 



3- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 

4- Applet2 is triggered 



5- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 



Envelope Handler availability with 
EVENT MENU SELECTION HELP REQUEST 



Perform SIM initialization with all the 
facilities supported 



Envelope menu selection with help request 
is sent to the SIM 



1-EnvelopeHandler . getlheHandler ( ) method 
is called by Appletl 



2-Envelope menu selection with help 
request is sent to the SIM 

3-EnvelopeHandler . getlheHandler ( ) method 
is called by Applet2 



1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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APDU Expectation 


3 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

l-Envelope menu selection is sent to the 
SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-Envelope menu selection is sent to the 

SIM 

4-EnvelopeHandler .getTheHandler () method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




4 


Envelope Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

l-A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 

4-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




5 


Envelope Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-An unformatted sms pp envelope is sent 
to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Envelope Handler availability with 
EVENT_FORMATTED_CB 

l-Envelope cell broadcast formatted is 
sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 

is called by Appletl 

3- Envelope cell broadcast formatted is 
sent to the SIM 

4-EnvelopeHandler .getTheHandler {) method 
is called by Applet2 


1- Appletl is triggered 

2-No exception is thrown 
Appletl finalizes 

3- Applet2 is triggered 
4-No exception is thrown 
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7 


Envelope Handler availability with 
EVENT_UNFORMATTED_CB 

l-Envelope cell broadcast unformatted is 
sent to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is tlirown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




8 


Envelope Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

l-Envelope Timer Expiration is sent to the 

SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Timer id=2 

3-Envelope Timer Expiration is sent to the 

SIM 

4-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




9 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by sim is sent to 
the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 


1- Appletl is triggered 

2- No exception is thrown. 




10 


Envelope Handler availability with 

EVENT MO SHORT MESSAGE CONTROL B 

Y_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl . 


1- Appletl is triggered 
2- No exception Is throw 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



286 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 


Description 


API/Framework Expectation 
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11 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




12 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

l-Envelope event download call connected 
is sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




13 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONE 

CTTED 

l-Envelope event download call 
disconnected is sent to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered. 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




14 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

l-Envelope event download location status 
is sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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15 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

l-Envelope event download user activity is 
sent to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is tlirown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




16 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

l-Envelope event download idle screen 
available is sent to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown. 




17 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

l-Envelope event download card reader 
status is sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




18 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD LANGUAGE 

SELECTION 

l-Envelope event download language 
selection is sent to the SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 
2-No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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19 


Envelope Handler availability with 

EVENT EVENT DOWNLOAD BROWSER 

TERMINATION 

l-Envelope event download browser 
termination is sent to the SIM 

2-EnvelopeHandler . getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 
2-No exception is tlirown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




20 


Envelope Handler availaibility with 
EVENT_STATUS_COMMAND 

l-Status command is sent to the SIM 

2-EnvelopeHandler .getTheHandler () method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler { ) method 
is called by Applet2 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 

Appletl finalizes 

3- Applet2 is triggered 

4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




21 


Envelope Handler availability with EVENT 
UNRECOGNIZED_ENVELOPE 

l-An unrecognized Envelope is sent to the 

SIM 

2-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 





6.3.1.3.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


2,3,4, 5,6, 7,8,9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 


CRRC1 


1,20 



6.3.1.4 EnvelopeResponseHandler 

Test Area Reference: FWK MHA ERHD 
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6.3.1.4.1 Conformance Requirement 

6.3.1.4.1.1 Normal Execution 

• CRRNl: The handler is available for all triggered toolkit applets from the invocation of the processTooUcit 
method of the toolkit applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_UNRECOGNIZED_ENVELOPE 

• CRRN2: After a call to the post method the handler is not longer available. 

• CRRN3: After a call to the send method the handler is not longer available. 

6.3.1 .4.1 .2 Parameters error 
No requirements. 

6.3.1.4.1.3 Context Errors 

• CRRCl: The handler is not available for the following events: 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1.4.2 Test Suite Files 

Test Script: FWK_MHA_ ERHD_1 .scr 

Test Applet: FWK_MHA_ ERHD_1 .Java 

FWK_MHA_ERHD_2.java 
Load Script: FWK_MHA_ ERHD_1 .Idr 
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Cleanup Script: 
Parameter File: 

6.3.1.4.3 



FWK_MHA_ ERHD_l.clr 
FWK_MHA_ ERHD_l.par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Toolkit Appletl and Toolkit Applet2 

registration and Envelope Response Handler 

availability with 

EVENT_PROFILE_DOWNLOAD 

1- Appletl Toolkit 1 is registered to all 
events defined in [7] . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Applet2 Toolkit 2 is registered to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNIZED_ENVELOPE . 

2-Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 
,SETUP_IDLE_MODE_TEXT, SETUP_MENU and 
POLL_INTERVAL . 

Appletl is triggered 

32-EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 

Appletl is deregistered to 
EVENT_PROF I LE_DOWNLOAD 


1 - No exception is thrown 

2- Appletl is triggered 

3- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




2 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1-Envelope menu selection with help 
request is sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




3 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION 

l-A envelope menu selection is sent to the 

SIM 

The Appletl is triggered 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 
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API/Framework Expectation 


APDU Expectation 


4 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_CB 

l-Envelope cell broadcast unformatted is 
sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




5 


Envelope Response Handler availability with 
EVENT_TIMER_EXPIRATION 

l-Envelope Timer Expiration is sent to the 

SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




6 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 

method is called by Appletl 


1- Appletl is triggered. 

2 -A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




7 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

l-Envelope event download call connected 
is sent to the SIM 

2-EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




8 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CALL DISCONN 

ECTED 

l-Envelope event download call 
disconnected is sent to the SIM 

2-EnvelopeResponseHandler .getTheHandler () 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



292 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 
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API/Framework Expectation 


APDU Expectation 


9 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD LOCATION STA 

TUS 

l-Envelope event download location status 
is sent to the SIM 

2-Applet A obtains the Envelope Response 
Handler 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
tlirown 




10 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

l-Envelope event download user activity is 
sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




11 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD IDLE SCREEN 

AVAILABLE 

l-Envelope event download idle screen 
available is sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




12 


Envelope Response Handler availability with 

EVENT EVENT DOWNLOAD CARD READER 

_STATUS 

l-Envelope event download card reader 
status is sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




13 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

l-Status command is sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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14 



Envelope Response Handler availability with 
EVENT FORMATTED SMS PP ENV 



l-A formatted sms pp envelope is sent to 
the SIM 



2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3-Appletl builds an additional information 
for response packet and it calls the post 
method 

4-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5-A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 



6-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7-Appletl builds a proactive command and 
it calls the sendO method 

8-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception is thrown. 



3- The response packet is 
sent 



4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



5- Appletl is triggered 



6- No Exception is thrown 



8- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



7- The proactive command 
is sent 
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15 



Envelope Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-A unformatted sms pp envelope is sent to 
the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 



3-Appletl builds the envelope response and 
it calls the postO method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception Is thrown. 



The Appletl finalizes 



5-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 



Applet2 finalizes. 



6-A unformatted sms pp envelope is sent to 
the SIM 



7-EnvelopeResponseHandler . getTheHandler ( ) 

method is called. 

8-Appletl builds a proactive command and 
it calls the sendO method 



9-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



5- Applet2 is triggered. 



6- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown. 



7- Appletl is triggered 



8- No exception is thrown. 



lO-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 



1 0- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 

11- Applet2 is triggered 



1 2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 



3- The envelope response is 
sent 



9- The proactive command 
is fetched and the Terminal 
response is issued. 
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16 



Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

l-Envelope call control by sim is sent to 
the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3-Appletl builds the envelope response and 
it calls the postAsBERTLV () method 

4-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5-Envelope call control by sim is sent to 
the SIM 

6-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7-Appletl builds a proactive command and 
it calls the sendO method 

8-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception Is thrown. 



4- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



5- Appletl is triggered 



6- No Exception is thrown 



3- The envelope response is 
sent 



7- The proactive command 
is fetched and the Terminal 
response is issued 



8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



17 



Envelope Response Handler availability with 

EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3-Appletl builds the envelope response and 
it calls the postAsBERTLV () method 

4-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5-Envelope mo short message control by sim 
is sent to the SIM 

6-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7-Appletl builds a proactive command and 
it calls the send method 

8-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception is thrown. 



3-The envelope response is 
sent 



4- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown for each method 

5- Appletl is triggered 



6- No exception is thrown 



8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



7- The proactive command 
is fetched and the Terminal 
Response is issued 
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18 



Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

l-An unrecognized Envelope is sent to the 

SIM 

2-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3-Appletl builds the envelope response and 
it calls the postAsBERTLV {) or post method 

4-Appletl calls all methods of Envelope 
Response Handler (including the inherited 
method) 

The Appletl finalizes 



54-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 



Applet2 finalizes 

6-An unrecognized Envelope is sent to the 

SIM 

7-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 

8-Appletl builds a proactive command and 
it calls the sendO method 



9-Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1- Appletl is triggered 



2- No exception Is thrown. 



3- The envelope response is 
sent 



4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Applet2 is triggered. 



6- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

7- Appletl is triggered. 



8- No exception is thrown. 



9- The proactive command 
is fetched and the Terminal 
response is issued 



lO-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 



1 0- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 

1 1 - Applet2 is triggered 



1 2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 
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19 



The envelope response is sent when a 
proactive session is ongoing 

l-A formatted SMS PP envelope is sent to 
the SIM. 



2-Proactive command DISPLAY TEXT is built 
and it calls the sendO method. 

3-A call control by sim envelope is sent 
to the SIM. 



4-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

5-Appletl builds the envelope response and 
it calls the postAsBERTLV 



1- Appletl is triggered. 



3- Appletl is triggered 



4- No exception is thrown 



2- 91 XX 



5-Tlie envelope response is 

sent 

9FYY 

GET RESPONSE 
Data 

91 XX 
Fetch DISPLAY TEXT 

Terminal Response 
DISPLAY TEXT 



NOTE: Due to an inconsistency in 3GPP TS 43.019 [7] specification it is not possible to cover the test case when an 
applet try to post data in multitriggering. 



6.3.1.4.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14, 15, 16, 17, 18, 19 


CRRN2 


14, 15, 16, 17, 18, 19 


CRRN3 


14, 15, 16, 17, 18, 19 


CRRC1 


1,2,3,4,5, 6,7,8,9, 10, 11, 12, 13 



6.3.2 Handler Integrity 
6.3.2.1 ProactiveHandler 

Test Area Reference: FWK_HIN_PAHD 

6.3.2.1.1 Conformance Requirement 

6.3.2.1.1.1 Normal Execution 

• CRRNl: At the processToolkit invocation the TLV-List is cleared. 

• CRRN2: After a call to ProactiveHandler. send method the handler will remain unchanged until the 
ProactiveHandler.init or appendTLV method are called. 



6.3.2.1.1.2 

No requirements. 



Parameters error 
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6.3.2.1.1.3 

No requirements. 

6.3.2.1.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.2.1.3 



Context Errors 

Test Suite Files: 

FWK_HIN_PAHD_1 .scr 
FWK_HIN_PAHD_1 .Java 
FWK_HIN_PAHD_2.java 
FWK_HIN_PAHD_1 .Idr 
FWK_HIN_PAHD_1 .clr 
FWK_HIN_PAHD_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


At the processToolkit invocation the TLV-List 
is cleared 

Appletl and Applet2 are registered to 
EVENT_UNFORMATTED_SMS_PP_ENV . 

1-An envelope containing an unformatted 
sms pp is sent to the SIM 

2-ProactiveHandler . getLength ( ) method is 
called by Appletl 


1- Appletl is triggered. 

2- The return value is 




2 


TLV-Llst change after the init method 
invocation 

ProactiveHandler . init ( ) method is called 
by Appletl 

1-ProactiveHandler .getLength method is 
called by Appletl 


1- The return value is 9 




3 


The TLV-Llst remains unchanged after the 
send() method invocation 

l-ProactiveHandler . send ( ) method is called 
by Appletl 

2-ProactiveHandler .getLength method is 
called by Appletl 

It's checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copyValue and 
Util . arrayCompare methods 


2- The return value is 9, and its 
contents is the same than before 
the calling to send method 


1 - The proactive command 
is fetched and the terminal 
response is issued. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


At the processToolkit invocation the TLV-List 
Is cleared 

l-ProactiveHandler . getLength ( ) method is 
called by Applet2 

2-ProactiveHandler . getValueLength ( ) method 
is called by Applet2 


1- Applet2 is triggered 

2- The return value is 

3- Tooll<itException 
UNAVAILABLE_ELEMENT is 
thrown 





6.3.2.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4 


CRRN2 


3 



6.3.2.2 



ProactiveResponseHandler 



Test Area Reference: FWK HIN PRHD 



6.3.2.2.1 
6.3.2.2.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl: The ProactiveResponseHandler content is changed after the call to ProactiveHandler.send method and 
remains unchanged until next call to the ProactiveHandler.send method. 

• CRRN2: The ProactiveResponseHandler may not be available before the first call to ProactiveHandler.send 
method, if available the content is cleared. 



6.3.2.2.1.2 

No requirements. 

6.3.2.2.1.3 

No requirements. 

6.3.2.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_HIN_PRHD_1 .scr 
FWK_HIN_PRHD_1 .Java 
FWK_HIN_PRHD_1 .Idr 
FWK_HIN_PRHD_1 .clr 
FWK_HIN_PRHD_1 .par 
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6.3.2.2.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration and 
ProactiveResponseHandler obtaining 

l-Applet is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry for 
EVENT_MENU_SELECTION, 
requestPollInterval for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Terminal Profile command is sent to the 
SIM without the facilities of 
SET_EVENT_LIST , SETUP_IDLE_MODE_TEXT, 
SETUP_MENU and POLL_INTERVAL . 

For each event : 

2-ProactiveResponseHandler . getTheHandler ( ) 
is called 

If handler is available, 

ProactiveResponseHandler . getLength ( ) is 
called 


1 - No exception is thrown 

2- Applet is triggered. 

3- Behaviour 1 : 
Toolkit Exception 
HANDLER_NOT_AVAILABLE is 
thrown. 

Behaviour 2: 

No exception is thrown, the return 
value is 




2 


The ProactiveResponseHandler remains 

unchanged after send method invocation until 

next send method invocation 

l-Applet builds a proactive command 
ProactiveHandler . send ( ) method is called 

2-ProactiveResponseHandler .getLength () 

method is called 

3-ProactiveHandler . init method is called 
4-ProactiveHandler . send ( ) method is called 

5-ProactiveResponseHandler . getLength ( ) 

method is called 


1 - The ProactiveResponseHandler 
contains the terminal response 

3- The return value is 12 

4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 

5- The ProactiveResponseHandler 
contains the terminal response of 
the second proactive command 

7- The return value is 1 5 


2- A proactive command is 
fetched 

The terminal response is sent 
with length 12 

6- A proactive command is 

fetched 

The terminal response is sent 

with length 15 



6.3.2.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1 
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6.3.2.3.1 
6.3.2.3.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The EnvelopeHandler and its content are available for all triggered toolkit applets, from the invocation 
to the termination of their processToolkit method 

• CRRN2: The SIM Toolkit Framework guarantees that all triggered toolkit applets receive the data. 



6.3.2.3.1.2 

No requirements. 

6.3.2.3.1.3 

No requirements. 

6.3.2.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_HIN_ENHD_1 .scr 
FWK_HIN_ENHD_1 .Java 
FWK_HIN_ENHD_1 .Idr 
FWK_HIN_ENHD_1 .clr 
FWK_HIN_ENHD_1 .par 
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6.3.2.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet initialization and Envelope Handler 

integrity checks with 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- Applet is registered to all events 

defined in [7] except 

EVENT_PROFILE_DOWNLOAD and 

EVENT_STATUS_COMMAND . 

Using the methods initMenuEntry () for 

EVENT_MENU_SELECTION, allocateTimer () for 

EVENT_TIMER_EXPIRATION, and setEventList ( ) 

for the rest of the events. 

Perform SIM initialization with all the 

facilities supported 

2-Envelope menu selection with help request 
is sent to the SIM 

3-EnvelopeHandler .getTheHandler method is 
called 



4-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_HELP_REQUEST 

5-A proactive command DISPLAY TEXT is sent 

6-Envelope call control by sim is sent to 
SIM 



EnvelopeHandler .getTheHandler method is 
called 



7- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 -No exception is thrown 



2- Applet is triggered 

3- No exception is thrown. 

4- No exception is thrown 



Check that the TAG_HELP_REQUEST is the TLV 
selected 

8-The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



5- 91 XX. 



6- Applet is triggered 



7- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



A proactive command 
Display Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



8- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Envelope Handler integrity checks with 
EVENT_MENU_SELECTION 








l-An envelope menu selection is sent to 

SIM 


1- Applet is triggered 






2-EnvelopeHandler .getTheHandler method is 


2- No exception is thrown. 






called 








3-Copy the contents of the envelope handler 


3- No exception is thrown. 






in buffer 1 using EnvelopeHandler . copy ( ) 








The EnvelopeHandler . findTLV method is 








called with TAG_ITEM_IDENTIFIER 








4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 




4- 91 XX 




SIM 


5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 








6- It's checked the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 




It's checked that the TAG_ITEM_IDENTIFIER 




the SIM 




is the TLV selected 








7- The contents of EnvelopeHandler are 








compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_FORMATTED_SMS_PP_ENV 

l-A formatted sms pp envelope is sent to 

SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_SMS_TPDU 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception Is thrown. 



It's checked that the TAG_SMS_TPDU is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare { ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Envelope Handler integrity checks with 
EVENT_FORMATTED_SMS_CB 








l-An envelope SMS-CB formatted according to 
[8] is sent to the SIM 


1- Applet is triggered 






2-EnvelopeHandler .getTheHandler method is 
called 


2-No exception is tlirown. 






3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 


3-No exception is tlirown. 






The EnvelopeHandler . findTLVO method is 
called with TAG_CELL_BROADCAST_PAGE 








4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 

SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler .getTheHandler method is 
called 








6-It ' s checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy () and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLVO method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It ' s checked that the 
TAG_CELL_BROADCAST_PAGE is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_PP_ENV 

l-A unformatted sms pp envelope is sent to 

SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 



The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It ' s checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_CB 








l-A unformatted cellbroadcast envelope is 
sent to SIM 


1- Applet is triggered 






2-EnvelopeHandler .getTheHandler method is 


2- No exception is thrown. 






called 








3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






The EnvelopeHandler . findTLVO method is 








called with TAG_CELLBROADCAST_PAGE 




4- 91 XX 




4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 


5- Applet is triggered 






SIM 








EnvelopeHandler .getTheHandler method is 








called 


6- No exception is thrown and the 






6-It ' s checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 


handler contains the envelope call 
control by SIM 






Util . arrayCompare ( ) methods 








The EnvelopeHandler . findTLVO method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




It's checked that the 








TAG_CELLBROADCAST_PAGE is the TLV selected 


7- The contents of the envelope 






7- The contents of EnvelopeHandler are 


handler shall be the same as stored 






compared with bufferl using 


in buffer 1. 






Util . arrayCompare ( ) 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_TIMER_EXPIRATION 

l-A timer expiration envelope is sent to 

SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_TIMER_ID 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_TIMER_IDE is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with 
EVENT_CALL_CONTROL_BY_SIM 

l-A call control envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with EVENT_ 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 

l-A mo short message control by sim 
envelope is sent to SIM 



2-EnvelopeHandler .getTheHandler method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1. 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



10 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_MT_CALL 

l-A event download mt call envelope is sent 
to SIM 



2-EnvelopeHandler .getTheHandler method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



11 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_CONNECTED 

l-A event download call connected envelope 
is sent to SIM 



2-EnvelopeHandler .getTheHandler method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 

compared with bufferl using 

Util ■ arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1. 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



12 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

l-A event download call disconnected 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It's checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1. 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



13 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_LOCATION_STATUS 

l-A event download location status envelope 
is sent to SIM 



2-EnvelopeHandler .getTheHandler method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_LOCATION_STATUS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



It's checked that the TAG_LOCATION_STATUS 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4-91 XX 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIIVI 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



14 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_USER_ACTIVITY 

l-A event download user activity envelope 
is sent to SIM 



2-EnvelopeHandler .getTheHandler method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare {) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4- 91 XX 



Proactive command Display 
Text is fetched 



The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



15 



Envelope Handler integrity checks with EVENT_ 

EVENT_DOWNLOADJDLE_SCREEN_AVAILAB 

LE 

l-A event download idle screen available 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler .getTheHandler method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



16 



Envelope Handler integrity checks with EVENT_ 
EVENT_DOWNLOAD_CARD_READER_STATUS 

l-A event download card reader status 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_CARD_READER_STATUS 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 



It's checked that the 
TAG_CARD_READER_STATUS is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1- Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIIVI 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



17 



Envelope Handler integrity checks with 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SEL 

ECTION 

l-A event download language selection 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler .getTheHandler method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2-No exception is thrown. 



3-No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_EVENT_LIST is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Envelope Handler integrity checks with 

EVENT_EVENT_DOWNLOAD_BROWSER_TERM 

INATION 

l-A event download browser termination 
envelope is sent to SIM 



2-EnvelopeHandler . getTheHandler ( ) method is 
called 



3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4-A proactive command DISPLAY TEXT is sent 

5-Envelope call control by sim is sent to 

SIM 



EnvelopeHandler .getTheHandler method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1- Applet is triggered 



2-No exception is thrown. 



3-No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_EVENT_LIST is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


19 


Envelope Handler integrity checks with 
UNRECOGNIZED_ENVELOPE 








l-A unrecognized envelope is sent to SIM 


1- Applet is triggered 






2-EnvelopeHandler .getTheHandler method is 
called 


2- No exception is thrown. 






3-Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 


3- No exception is thrown. 






4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 

SIM 


5- Applet is triggered 


4- 91 XX 




EnvelopeHandler . getTheHandler ( ) method is 

called 

The EnvelopeHandler .getValueLength is 

called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findXLV method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



6.3.2.3.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7,8,9, 10, 11, 12, 13, 14, 15, 16,17,18,19 


CRRN2 


1, 2, 3,4,5, 6,7,8, 9, 10, 11, 12, 13, 14, 15, 16,17,18,19 



6.3.3 Applet Triggering 

6.3.3.1 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: FWK APT EPDW 



6.3.3.1.1 



6.3.3.1.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: Upon the reception of Terminal Profile command by the SIM, the STF stores the ME Profile and then 
triggers the registered toolkit applets. 
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• CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from this 
event. 

• CRRN3: The STF shall not reply busy to a Terminal Profile command 

6.3.3.1 .1 .2 Parameters error 
No requirements. 

6.3.3.1 .1 .3 Context Errors 
No requirements. 

6.3.3.1.2 Test Suite Files 

Test Script: FWK_APT_EPDW_l.scr 

Test Applet: FWK_APT_EPDW_l.java 

FWK_APT_EPDW_2.java 

FWK_APT_EPD W_3 .j ava 

FWK_APT_EPDW_1 .Mr 

FWK_APT_EPDW_1 .clr 

FWK_APT_EPDW_1 .par 

Test Procedure 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.1.3 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applets is not registered to the 
EVENT_PROFILE_DOWNLOAD and is registered 
to EVENT_FORMATTED_SMS_PP_ENV. 








1-Terminal Profile command is sent to SIM 


1- Appletl is triggered 

Appletl finalizes 

2- Applet2 is triggered 

Applet2 finalizes 

3- Applets is not triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


The STF shall not reply busy to a Terminal 
Profile command 








l-Formatted sms pp envelope is sent to SIM 


1- Applets is triggered by the 
EVENT FORMATTED SIVIS PP 
ENV 






Applets builds a REFRESH proactive command 








in sim initialization mode 








2-ProactiveHandler . send method is called 








by applets 


Applets is suspended until the 
terminal response 


2- A proactive command is 
sent 




3-Terminal Profile command is sent to SIM 


3- Appletl is triggered by 
EVENT_PROFILE_DOWNLOAD 






Appletl calls Toolkit Registry . clearEvent ( 








EVENT_PROF I LE_DOWNLOAD ) 


Appletl finalizes 

4- Applet2 is triggered by 

EVENT PROFILE DOWNLOAD 






4-Applet2 calls Toolkit 
Registry . clearEvent ( 




The terminal Response of 
the proactive command is 
sent 




EVENT_PROF I LE_DOWNLOAD ) 








ToolkitRegistry . setEvent (EVENT_PROFILE_DOW 








NLOAD) method is called 


Applet2 finalizes 
Applets finalizes 




3 


Deregistered applets are not triggered 

Terminal Profile command is sent to SIM 


Applets is triggered 
(Appletl and Applet2 are not 
triggered) 





6.3.3.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRNS 


2 



6.3.3.2 EVENT_MENU_SELECTION 

Test Area Reference: FWK APT EMSE 



6.3.3.2.1 



Conformance Requirement 



6.3.3.2.1.1 



Normal Execution 



CRRNl: The applet is triggered by the EVENT_MENU_S ELECTION when an Envelope Menu Selection is 
received with the item identifier of a menu entry of this applet if no proactive session is ongoing. 
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6.3.3.2.1.2 

No requirements. 

6.3.3.2.1.3 

No requirements. 

6.3.3.2.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_1 .Java 
FWK_APT_EMSE_2.j ava 
FWK_APT_EMSE_1 .Idr 
FWK_APT_EMSE_1 .clr 
FWK_APT_EMSE_1 .par 



6.3.3.2.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_MENU_SELECTION and triggering 



ToolkitRegistry . initMenuEntry method is 
called in the constructor of appletl and 
Applet2 . 

For appletl : 
MenuEntry="Appletl " 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

For applet2 : 
MenuEntry="Applet2 " 
Offset=0 

Length=menuEntry . length 
HelpSupported= false 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION 
1-ToolkitRegistry . isEventSet is called 
in constructor. 



Perform SIM initialization the facility 
SET UP MENU and without the facilities SET 
EVENT LIST and POLL INTEVAL features 



2-Item Identifier = 1 

Event Menu Selection envelope is sent to 
the SIM with the item identifier of a menu 
entry of applet 



3-Item Identifier = 2 

Event Menu Selection envelope is sent to 
the SIM with the item identifier of a menu 
entry of applet 



1- The method must return true. 



2- Appletl is triggered and applet2 
is not triggered 



Appletl finalizes 

3- Applet2 is triggered and appletl 

is not triggered 
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6.3.3.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: FWK_APT_EMSH 



6.3.3.3.1 



6.3.3.3.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : If and ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then STF shall trigger the corresponding applet. 



6.3.3.3.1.2 

No requirements. 

6.3.3.3.1.3 

No requirements. 

6.3.3.3.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMSH_1 .scr 
FWK_APT_EMSH_1 .Java 
FWK_APT_EMSH_2.j ava 
FWK_APT_EMSH_1 .Idr 
FWK_APT_EMSH_1 .clr 
FWK_APT_EMSH_1 .par 
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6.3.3.3.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_MENU_SELECTION_HELP_REQUEST 

and triggering 

ToolkitRegistry . InitMenuEntry method is 
called in the constructor of appletl and 
Applet2 . 

For Appletl : 
MenuEntry="Appletl" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2 : 
MenuEntry="Applet2" 
Offset=0 

Length=menuEntry . length 
HelpSupported=true 
IconQualif ier=0 
Iconldentif ier=0 








event= EVENT_MENU_SELECTION_HELP_REQUEST 
1-ToolkitRegistry .isEventSet is called 
in constructor. 


1-The command must retum true. 






Perform SIM initialization the facility 
SET UP MENU and without the facilities SET 
EVENT LIST and POLL INTEVAL features 








2-Item identifier =1 

Menu Selection Help Request envelope is 
sent to the SIM with the item identifier 
of a menu entry of applet 


2- Appletl is triggered and applet2 
is not triggered 






3-Item identifier =2 

Menu Selection Help Request envelope is 
sent to the SIM with the item identifier 
of a menu entry of applet 


Appletl finalizes 

3- Applet2 is triggered and appletl 

is not triggered 





6.3.3.3.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV 

Test Area Reference: FWK APT EFSE 
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6.3.3.4.1 Conformance Requirement 

6.3.3.4.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_FORMATTED_SMS_PP_EN V once: 

it has been registered to this event; 
- an envelope APDU carrying an SMS TPDU formatted according to 3GPP TS 23.048 [8], is received; 
the toolkit applet to be triggered is registered with the corresponding TAR in the SMS TPDU; 
the security is verified. 

• CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 



6.3.3.4.1.2 

No requirements. 

6.3.3.4.1.3 

No requirements. 

6.3.3.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.4.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EFSE_1 .scr 
FWK_APT_EFSE_1 .Java 
FWK_APT_EFSE_1 .Idr 
FWK_APT_EFSE_1 .clr 
FWK_APT_EFSE_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to EVENT 
FORM>* 7T£D_SMS_PP_ENV and triggering 

Applet is registered to 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNI ZED_ENVELOPE 

1-An Envelope EVENT_FORMATTED_SMS_PP_ENV 
is sent to the SIM. 


1- Applet Is triggered 




2 


Applet deregistration 

ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

2-A formatted sms pp envelope is sent to 
the SIM. 

An unrecognized envelope is sent to the 

sim 

ToolkitRegistry . setEvent method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

3-An Envelope FORMATTED_SMS_PP_ENV is sent 
to the SIM 


1- Applet is not triggered 

2- Applet Is triggered 
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6.3.3.4.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 (See note) 


1 


CRRN2 


2 


NOTE: The security checks are not relevant to the test 
designed in this test area; they will be checked in 
subclause 6.3.6. 



6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EUSE 



6.3.3.5.1 



6.3.3.5.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_UNFORMATTED_SMS_PP_ENV once it has registered to this 
event and an Unformatted Envelope DataDownLoad is received if no proactive session is ongoing. 

CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 



6.3.3.5.1.2 

No requirements. 

6.3.3.5.1.3 

No requirements. 

6.3.3.5.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.5.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EUSE_1 .scr 
FWK_APT_EUSE_1 .Java 
FWK_APT_EUSE_1 .Idr 
FWK_APT_EUSE_1 .ck 
FWK_APT_EUSE_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_UNFORMATTED_SMS_PP_ENV and 

triggering 

Applet is registered to the 
EVENT_UNFORMATTED_SMS_PP_ENV and 
ENVENT_FORMATTED_SMS_PP_ENV . 








1-Toolkit Registry . isEventSet ( ) method is 


1- The method returns true 






called for EVENT_UNFORMATTED_SMS_PP_ENV 








2-An Envelope UNFORMATTED_SMS_PP_ENV is 


2- Applet is triggered 






sent to the SIM. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Toolkit Registry . clearEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 
1-An unformatted sms pp envelope is sent 
to the SIM. 

A formatted sms pp envelope is sent to the 

sim 

Toolkit Registry . setEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS„PP_ENV 

2-An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.5.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.6 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK_APT_ECCN 



6.3.3.6.1 



6.3.3.6.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_CALL_CONTROL_B Y_SIM once it has registered to this 
event and an Envelope Call Control is received. 

• CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_BY_SIM once it has deregistered from 
this event. 



6.3.3.6.1.2 

No requirements. 

6.3.3.6.1.3 

No requirements. 

6.3.3.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_ECCN_1 .scr 
FWK_APT_ECCN_1 .Java 
FWK_APT_ECCN_1 .Idr 
FWK_APT_ECCN_1 .clr 
FWK_APT_ECCN_1 .par 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



329 



ETSI TS 151 013 V4.1.0 (2003-12) 



6.3.3.6.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 

EVENT_CALL_CONTROL_BY_SIM and 

triggering 

Appletl is registered to 
EVENT_CALL_CONTROL_BY_SIM. 

Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV 

1-An Envelope Call control by SIM is sent 








to SIM 


1- Appletl is triggered 




2 


Applet deregistration and registration of the 

third applet to EVENT CALL- 

CONTROL_BY_SIM. 








l-An Envelope Formatted SMS PP envelope is 
sent to SIM 


1-Applet2 is triggered by 
EVENT FORMA 1 1 hD SMS PP 
ENV. 






Applet2 contructs a DISPLAY TEXT proactive 








command. 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 




3-An Envelope Call control by SIM envelope 


3- Appletl is triggered 






is sent to SIM 








ToolkitRegistry . clearEvent is called for 








EVENT_CALL_CONTROL_BY_SIM. 




TERMINAL RESPONSE of 






Appletl finalizes. 


DISPLAY TEXT is sent to 
the SIM 




ToolkitRegistry . setEvent method is 








called for EVENT_CALL_CONTROL_BY_SIM. 


Applet2 finalizes 




3 


Applet triggering 








An Envelope Call control by SIM envelope 
is sent to SIM 


Applet2 is triggered. 
(Appletl is not triggered) 





6.3.3.6.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 
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6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK APT EMCN 



6.3.3.7.1 
6.3.3.7.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_MO_SHORT_MESS AGE_CONTROL_B Y_SIM once it has 
registered to this event and an Envelope MO Short Message Control. 

• CRRN2: The applet is not triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it 
has deregistered from this event. 



6.3.3.7.1.2 

No requirements. 

6.3.3.7.1.3 

No requirements. 

6.3.3.7.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.7.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMCN_1 .scr 
FWK_APT_EMCN_1 .Java 
FWK_APT_EMCN_2.java 
FWK_APT_EMCN_1 .Idr 
FWK_APT_EMCN_1 .clr 
FWK_APT_EMCN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM and triggering 

Appletl is reggistered to 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 

Applet2 is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 








1-An Envelope MO short message envelope is 


1- Appletl is triggered. 






sent to SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration and registration of the 

third applet to 
EVENT MO SHORT MESSAGE CONTROL B 

Y_SIM. 

The STF shall not reply busy to a call control 

envelope 








l-An Envelope formatted SMS PP envelope is 
sent to SIM. 


1- Applet2 is triggered. 






Applet2 builds a DISPLAY TEXT proactive 








command. 

2-ProactiveHandler . send ( ) method is 
called. 




2- A Proactive command 
DISPLAY TEXTIs sent and 
applet is suspended until 
the terminal response 




3-An Envelope MO Short message envelope is 
sent to SIM 


3- Appletl is triggered. 






ToolkitRegistry . clearEvent ( ) for 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 








ToolkitRegistry . setEvent method is 
called for 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 


Appletl finalizes. 
Applet2 finalizes. 


TERMINAL RESPONSE of 
DISPLAY TEXT is sent to 
the SIM 


3 


Applets triggering 








An Envelope MO SMS control by SIM envelope 
is sent to SIM 


Applet2 is triggered. 
(Appletl is not triggered) 





6.3.3.7.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 



6.3.3.8 EVENT_TIMER_EXPIRATION 

Test Area Reference: FWK_APT_ETEX 



6.3.3.8.1 



6.3.3.8.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this event 
and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive session is 
ongoing. 

• CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered from 
this event. 
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6.3.3.8.1.2 

No requirements. 

6.3.3.8.1.3 

No requirements. 

6.3.3.8.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.8.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_ETEX_1 .scr 
FWK_APT_ETEX_1 .j ava 
FWK_APT_ETEX_1 .Idr 
FWK_APT_ETEX_1 .clr 
FWK_APT_ETEX_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_TIMER_EXPIRATION and 

triggering 

Applet is registered to the 
EVENT_TIMER_EXPIRATION using the 
allocateTimer ( ) method and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_TIMER_EXPIRATION 
1-Toolkit Registry . isEventSet 
method is called. 

2-An Envelope TIMER„EXPIRATION is 
sent to the SIM. 


1- The method returns true 

2- Applet is triggered. 




2 


Applet deregistration 

Timer id=l 

Toolkit Registry. ReleaseTimerO method 

is called 

1-An Envelope timer expiration is 
sent to the SIM. 

An Envelope formated sms pp envelope 
is sent to the sim 

Toolkit Registry. AllocateTimer method 
is called 

2-An Envelope TIMER_EXPIRATION is 
sent to the SIM. 


1- Applet isn't triggered 

2- Applet is triggered 





6.3.3.8.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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6.3.3.9 EVENT_UNFORMATTED_SMS_CB 

Test Area Reference: FWK APT EUCB 



6.3.3.9.1 
6.3.3.9.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_UNFORMATTED_SMS_CB once it has registered to this event 
and an Envelope Cell Broadcast DownLoad is received. 

• CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_CB once it has deregistered from 
this event. 



6.3.3.9.1.2 

No requirements. 

6.3.3.9.1.3 

No requirements. 

6.3.3.9.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.9.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EUCB_1 .scr 
FWK_APT_EUCB_1 .Java 
FWK_APT_EUCB_1 .Mr 
FWK_APT_EUCB_1 .clr 
FWK_APT_EUCB_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_UNFORMATTED_SMS_CB and 

triggering 

Applet is registered to the 
EVENT_UNFORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_UNFORMATTED_SMS_CB 








1-Toolkit Registry. isEventSet method is 
called. 


1- Method returns true. 






2-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 


2- Applet is triggered 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Applet deregistration 

Toolkit Registry . ClearEvent () method is 
called for EVENT_UNFORMATTED_SMS„CB 








1-An Envelope UNFORMATTED_SMS_CB is sent 


1 - Applet isn't triggered 






to the SIM. 








An Envelope formatted sms pp envelope is 








sent to the sim 








event= EVENT_UNFORMATTED_SMS_CB 








Toolkit Registry. setEvent method is called 








for EVENT_UNFORMATTED_SMS_CB 








2-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 


2- Applet is triggered 





6.3.3.9.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: FWK APT EDMC 



6.3.3.10.1 



6.3.3.10.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_MT_C ALL once it has registered to 
this event and an Envelope Event DownLoad MT Call is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has 
deregistered from this event. 



6.3.3.10.1.2 
No requirements. 

6.3.3.10.1.3 
No requirements. 

6.3.3.10.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_1 .Java 
FWK_APT_EMSE_1 .Idr 
FWK_APT_EMSE_1 .clr 
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Parameter File: 



FWK_APT_EMSE_1 .par 



6.3.3.10.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_MT_CALL and 

triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
1-Toolkit Registry . isEventSet method is 
called. 

2 -An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1- The method returns true 

2- Applet is triggered 




2 


Applet dereglstration 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1-An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . setEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

2-An Envelope EVENT„DOWNLOAD__MT_CALL is 
sent to the SIM. 


1- Applet isn't triggered 

2- Applet is triggered 





6.3.3.10.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.1 1 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: FWK_APT_EDCC 



6.3.3.11.1 



Conformance Requirement 



6.3.3.11.1.1 



Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 
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• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
deregistered from this event. 



6.3.3.11.1.2 
No requirements. 

6.3.3.11.1.3 
No requirements. 

6.3.3.11.2 
Test Script: 
Test Applet: 
Load Script: 
Clean-up Script: 
Parameter File: 

6.3.3.11.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDCC_1 .scr 
FWK_APT_EDCC_1 .Java 
FWK_APT_EDCC_1 .Idr 
FWK_APT_EDCC_1 .clr 
FWK_APT_EDCC _l.par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_CONNECT 

ED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
1-Toolkit Registry .isEventSet method is 

called. 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 


1- Method returns true 

2- Applet is triggered. 




2 


Applet deregistration 

event=EVENT„EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1-A call connected event dowload is sent 
to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

Event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 


1- Applet isn't triggered 
2- Applet is triggered 
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6.3.3.11.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.1 2 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: FWK APT EDCD 



6.3.3.12.1 



6.3.3.12.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it 
has deregistered from this event. 



6.3.3.12.1.2 
No requirements. 

6.3.3.12.1.3 
No requirements. 

6.3.3.12.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.12.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDCD_1 .scr 
FWK_APT_EDCD_1 .Java 
FWK_APT_EDCD_1 .Idr 
FWK_APT_EDCD_1 .clr 
FWK_APT_EDCD_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD_CALL_DISCONN 

ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED and 
to EVENT_FORMATTED_SMS_PP_ENV. 



Event=EVENT_EVENT_DOWNLOAD_CALL_DISCONNECT 

ED 

1-Toolkit Registry . isEventSet ( ) method is 

called. 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 



1- Method returns true 



2- Applet is triggered. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1-An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the SIM. 

a formatted sms pp envelope is sent to the 

sim. 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Toolkit Registry . setEvent method is 

called 

Perform SIM initialization with all the 

facilities supported 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 


1- Applet isn't triggered 

2- Applet is triggered 





6.3.3.12.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.1 3 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: FWK APT EDLS 



6.3.3.13.1 



6.3.3.13.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LOC ATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it has 
deregistered from this event. 



6.3.3.13.1.2 
No requirements. 

6.3.3.13.1.3 
No requirements. 

6.3.3.13.2 
Test Script: 
Test Applet: 
Load Script: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDLS_1 .scr 
FWK_APT_EDLS_1 .Java 
FWK APT EDLS l.ldr 
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Cleanup Script: 
Parameter File: 

6.3.3.13.3 



FWK_APT_EDLS_1 .clr 
FWK_APT_EDLS_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LOACTION_STA 

TUS and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS and 
to EVENT_FORMATTED_SMS_PP_ENV. 

Event =EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 
1-Toolkit Registry . isEventSet method is 
called. 

2-An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS i s 
sent to the SIM. 


1- Method returns true 

2- Applet is triggered. 




2 


Applet deregistration 

Event=EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Toolkit Registry . clearEvent method is 

called 

Perform SIM initialization with all the 

facilities supported 

1-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 

Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 

facilities supported 

2-An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 


1- Applet isn't triggered 

2- Applet is triggered 





6.3.3.13.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Test Area Reference: FWK APT EDUA 
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6.3.3.14.1 



6.3.3.14.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
registered to this event and an Envelope Event DownLoad User Activity is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



6.3.3.14.1.2 
No requirements. 

6.3.3.14.1.3 
No requirements. 

6.3.3.14.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.14.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDUA_1 .scr 
FWK_APT_EDUA_1 .Java 
FWK_APT_EDUA_1 .Idr 
FWK_APT_EDUA_1 .clr 
FWK_APT_EDUA_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_FORMATTED_SMS_PP_ENV . 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1-Toolkit Registry . isEventSet method is 
called. 

2-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1- Method returns true 

2- Applet is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 








1-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1- Applet isn't triggered 






a formatted sms pp envelope is sent to the 








Sim 








Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 








Toolkit Registry . setEvent ( ) method is 








called 








Perform SIM initialization with all the 








facilities supported 








2-An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 


2- Applet is triggered 






is sent to the SIM. 







6.3.3.14.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.15 EVENT_EVENT_DOWNLOADJDLE_SCREEN_AVAILABLE 

Test Area Reference: FWK_APT_EDIS 



6.3.3.15.1 
6.3.3.15.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE once 
it has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has deregistered from this event. 



6.3.3.15.1.2 
No requirements. 

6.3.3.15.1.3 
No requirements. 

6.3.3.15.2 
Test Script: 
Test Applet: 
Load Script: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDIS_l.scr 
FWK_APT_EDIS_1 .Java 
FWK APT EDIS l.ldr 
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Cleanup Script: 
Parameter File: 

6.3.3.15.3 



FWK_APT_EDIS_l.clr 
FWK_APT_EDIS_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_ 

AVAILABLE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

1-Toolkit Registry . isEventSet method is 

called. 

2-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event=EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 

Toolkit Registry . clearEvent method is 

called 

Perform SIM initialization with all the 

facilities supported 

1-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 

facilities supported 

2-An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 


1- Applet isn't triggered 
2- Applet is triggered 





6.3.3.15.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: FWK_APT_EDCR 
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6.3.3.16.1 



6.3.3.16.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it 
has registered to this event and Envelope Event DownLoad Card Reader Status is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once 
it has deregistered from this event. 



6.3.3.16.1.2 
No requirements. 

6.3.3.16.1.3 
No requirements. 

6.3.3.16.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.16.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDCR_1 .scr 
FWK_APT_EDCR_1 .Java 
FWK_APT_EDCR_1 .Idr 
FWK_APT_EDCR_1 .clr 
FWK_APT_EDCR_1 .par 

Test Procedure 



id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_CARD_READER 

_STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event=EVENT_EVENT_DOWNLOAD_CARD_READER_STA 

TUS 

1-Toolkit Registry . isEventSet method is 

called. 

2-An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 


1- Method returns true 

2- Applet is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 








1-An Envelope 

EVENT DOWNLOAD CARD READER STATUS is sent 


1- Applet isn't triggered 






to the SIM. 








An Envelope formatted sms pp envelope is 








sent to the sim 








Event= 








EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 








Toolkit Registry . setEvent method is 








called 








Perform SIM initialization with all the 








facilities supported 








2-An Envelope 


2- Applet Is triggered 






EVENT DOWNLOAD CARD READER STATUS is sent 








to the SIM. 







6.3.3.16.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_APT_EUEV 



6.3.3.17.1 



6.3.3.17.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

• CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered 
from this event. 



6.3.3.17.1.2 
No requirements. 

6.3.3.17.1.3 
No requirements. 



Parameters error 



Context Errors 
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6.3.3.17.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.17.3 



Test Suite Files 

FWK_APT_EUEN_1 .scr 
FWK_APT_EUEN_1 .Java 
FWK_APT_EUEN_1 .Mr 
FWK_APT_EUEN_1 .clr 
FWK_APT_EUEN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_UNRECOGNIZED_ENVELOPE and 

triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE and to 
EVENT_FORMMATTED_SMS_PP_ENV 

Event= EVENT_UNRECOGNI ZED_ENVELOPE 
1-Toolkit Registry .isEventSet method is 
called. 

2-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1- Method returns true 

2- Applet Is triggered 




2 


Applet dereglstration 

Event= EVENT_UNRECOGNI ZED_ENVELOPE 
Toolkit Registry . clearEvent method is 
called 

1-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= EVENT_UNRECOGNI ZED_ENVELOPE 
Toolkit Registry . setEvent ( ) method is 
called 

2-An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1- Applet Isn't triggered 

2- Applet Is triggered 





6.3.3.17.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.18 EVENT_STATUS_COMMAND 

Test Area Reference: FWK_APT_ESTC 
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6.3.3.18.1 



6.3.3.18.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_STATUS_COMMAND once it has registered to this event and 
a Status Command is received. 

CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 



6.3.3.18.1.2 
No requirements. 

6.3.3.18.1.3 
No requirements. 

6.3.3.18.2 
Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.18.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_ESTC_1 .scr 
FWK_APT_ESTC_1 .Java 
FWK_APT_ESTC_2.java 
FWK_APT_ESTC_3 .j ava 
FWK_APT_ESTC_1 .Idr 
FWK_APT_ESTC_1 .clr 
FWK_APT_ESTC_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 
EVENT_STATUS_COMMAND and triggering 

Appletl is registered to 
EVENT_STATUS_COMMAND using the 
requestPollInterval command. 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval ( ) command. 

Applets is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-A status command is sent to SIM 


1- Appletl is triggered. 
Appletl finalizes 

2- Applet2 is triggered. 
Applet2 finalizes 

3- Applets is not triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration and registration of the 

third applet to EVENT_STATUS_COMMAND. 

The STF shall not reply busy to a call control 

envelope 








l-A formatted sms pp envelope is sent to 
SIM 


1- Applets is triggered. 






Applets builds a DISPLAY TEXT. 

2- ProactiveHandler . send is called 




2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 




3-A status command is sent to SIM. 


3- Appletl is triggered. 






requestPollInteval with POLL_NO_DURATION 
is called 








requestPollInteval with POLL_NO_DURATION 
is called 


Appletl finalizes 

4- Applet2 is triggered. 






requestPollInterval method is called. 


Applet2 finalizes 








Applets finalizes 


5- TERMINAL RESPONSE 
of DISPLAY TEXT is sent to 
the SIM 


3 


Applets triggering 

Perform SIM initialization with all the 
facilities supported 








Status command is sent to SIM. 


Applets is triggered. 
(Appletl and Applet2 are not 
triggered) 





6.3.3.18.4 



Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3 



6.3.3.19 EVENT_FORMATTED_SMS_CB 

Test Area Reference: FWK_APT_EFCB 

6.3.3.19.1 Conformance Requirement 

6.3.3.19.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_FORMATTED_SMS_CB once: 
it has been registered to this event; 
- an envelope APDU carrying a Cell Broadcast Page, formatted according to 3GPP TS 23.048 [8], is received; 
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the toolkit applet to be triggered is registered with the corresponding TAR in the CB page; 

the security is verified. 

CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_CB once it has deregistered from this 
event. 



6.3.3.19.1.2 
No requirements. 

6.3.3.19.1.3 
No requirements. 

6.3.3.19.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.19.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EFCB_1 .scr 
FWK_APT_EFCB_1 .Java 
FWK_APT_EFCB_1 .Idr 
FWK_APT_EFCB_1 .clr 
FWK_APT_EFCB_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_FORMATTED_SMS_CB and triggering 

Applet is registered to 
EVENT_FORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV 

1-An Envelope EVENT_FORMATTED_SMS_CB is 
sent to the SIM. 


1 -Applet is triggered 




2 


Applet deregistration 

ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_CB 

1-A formatted SMS CB envelope is sent to 
the SIM. 

2-An envelope SMS-PP formatted is sent to 
the SIM 

ToolkitRegistry . setEvent method is 
called for EVENT_FORMATTED_SMS_CB 

3-An Envelope FORMATTED_SMS_CB is sent to 
the SIM 


1- Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 
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6.3.3.19.4 



Test Coverage 



CR Number 


Test Case Number 


CRRN1 (See note) 


1,2 


CRRN2 


2 


NOTE: The security checks are not relevant to the test 
designed in this test area; they will be checked in 
subclause 6.3.6. 



6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

Test Area Reference: FWK_APT_EDLG 



6.3.3.20.1 



6.3.3.20.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION once it 
has registered to this event and an Envelope Event DownLoad Language Selection is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION once 
it has deregistered from this event. 



6.3.3.20.1.2 

No requirements. 

6.3.3.20.1.3 
No requirements. 

6.3.3.20.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.20.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDLG_1 .scr 
FWK_APT_EDLG_1 .Java 
FWK_APT_EDLG_1 .Idr 
FWK_APT_EDLG_1 .clr 
FWK_APT_EDLG_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SE 

LECTION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
and to EVENT_FORMATTED_SMS_PP_ENV. 

Event= 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 








1-Toolkit Registry . isEventSet method is 
called. 


1 -Method returns true 






2-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the SIM. 


2- Applet Is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Language Selection facilities . 

1-An Envelope 

EVENT_DOWNLOAD„LANGUAGE_SELECTION is sent 
to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
Toolkit Registry . setEvent method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Language Selection facilities . 

2-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.20.4 



Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

Test Area Reference: FWK APT EDBT 



6.3.3.21.1 



6.3.3.21.1.1 



Conformance Requirement 
Normal Execution 



CRRNl: The applet is triggered by the EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION once it 
has registered to this event and an Envelope Event DownLoad Browser Termination is received. 

CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
once it has deregistered from this event. 



6.3.3.21.1.2 
No requirements. 

6.3.3.21.1.3 
No requirements. 



Parameters error 



Context Errors 
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6.3.3.21.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.21.3 



Test Suite Files 

FWK_APT_EDBT_1 .scr 
FWK_APT_EDBT_1 .Java 
FWK_APT_EDBT_1 .Idr 
FWK_APT_EDBT_1 .clr 
FWK_APT_EDBT_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 

EVENT_EVENT_DOWNLOAD_ 

BROWSER_TERMINATION and triggering 



Applet is registered to the 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

1-Toolkit Registry. isEventSet method is 
called. 

2-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



1 -Method returns true 
2- Applet is triggered 



Applet dereglstration 



Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Browser Termination facilities. 

1-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



a formatted sms pp envelope is sent to the 

sim 

Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Browser Termination facilities . 

2-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



1- Applet isn't triggered 



2- Applet is triggered 
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6.3.3.21.4 



Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.4 Proactive Command Sending by tine STF 
6.3.4.1 System Proactive Commands 

Test Area Reference: FWK PCS SPCO 



6.3.4.1.1 



6.3.4.1.1.1 



Conformance Requirements 



Normal Execution 



• CRRNl : When a toolkit applet changes a menu entry of its registry object, the SIM Toolkit Framework shall 
dynamically* update the menu stored in the ME during the current card session 

• CRRN2: The STF shall use the data of the EFsume file when issuing the SET UP MENU proactive command. 

• CRRN3: For all EVENT_EVENT_DOWNLOAD_*: When a toolkit applet changes one or more of these 
requested events of its registry object, the STF shall dynamically* update the event list stored in the ME during 
the current card session by SET UP EVENT LIST proactive command. 

NOTE: *The STF shall send its system proactive command as soon as no proactive session is pending and all the 
applets registered to the current events have been triggered and have returned from the processToolkit 
method invocation. 



6.3.4.1.1.2 

No requirements. 

6.3.4.1.1.3 

No requirements. 

6.3.4.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.4.1.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_PCS_SPCO_l .scr 
FWK_PCS_SPCO_l .Java 
FWK_PCS_SPCO_l .Idr 
FWK_PCS_SPCO_l.clr 
FWK_PCS_SPCO_l .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Install Applet 1 , Registered to the 

EVENT EVENT DOWNLOAD MT CALL and 

EVENT EVENT DOWNLOAD 

LOCATION_STATUS 

Perform SIM initialization with EVENT 
DOWNLOAD facilities supported 




setEventList proactive 

command 

[Event llst]='1 9020003- 

or ■99020003' 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Trigger the applet by ENVELOPE 




1. DISPLAY TEXT 




(SMS_FORMATTED_PP) command 




Proactive command 




Clear the events and build a display text 








command 




2. SET UP EVENT LIST 
Proactive command 

[ComnnandQualifier]= OOh 



6.3.4.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


see: 
subclause6.2.9.2, CRRN1, 
subclause 6.2.9.4, CRRN3, 
subclause 6.2.9.5 CRRN4, 
subclause 6.2.9.8 CRRN1 


N2 


see: 
subclause 6.2.9.2 CRRN1, 
subclause 6.2.9.8 CRRN1 


N3 


1,2 



6.3.4.2 Interaction with GSM commands 

Test Area Reference: FWK_PCS_IGCO 



6.3.4.2.1 



6.3.4.2.1.1 



Conformance Requirements 
Normal Execution 



CRRNl: The STF shall process a GSM command even when a proactive command is pending (before and after 
the FETCH command until the terminal response). The STF shall answer with the SWl and SW2 described in 
3GPPTS 51.011 [3] and 3GPPTS 51.014 [4]. 



6.3.4.2.1.2 

No requirements. 

6.3.4.2.1.3 

No requirements. 

6.3.4.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_PCS_IGCO_l .scr 
FWK_PCS_IGCO_l .Java 
FWK_PCS_IGCO_l .Idr 
FWK_PCS_IGCO_l .clr 
FWK_PCS_IGCO_l .par 
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6.3.4.2.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Interaction with GSM Commands after 

TERMINAL PROFILE in connection with FETCH 

and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

(Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 

2- SELECT MF 

3- GET RESPONSE (6 Bytes) 

4- Failed SELECT File 

5- FETCH 

6- SELECT MF 

1' GET RESPONSE (6 Bytes) 
8- TERMINAL RESPONSE 




1-91XX 

2- 9Fxx 

3- 91 XX 

4- 9404 

5- Proactive Command: 

SETUP MENU 

6- 9Fxx 

7- 9000 

8- 9000 


2 


Interaction with GSM Commands after 

ENVELOPE (MENU SELECTION) 

in connection with FETCH and TERMINAL 

RESPONSE 

Menu Entry ID = 0x01 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- GET RESPONSE (6 Bytes) 

7- TERMINAL RESPONSE 




1-9FXX 

2- 91 XX 

3- 9404 

4- Proactive Command: 

DISPLAY TEXT 

5- 9FXX 

6- 9000 

7- 9000 


3 


Interaction with GSM Commands after 
TERMINAL RESPONSE in proactive command 
session in connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- FETCH 

4- SELECT MF 

5- GET RESPONSE (6 Bytes) 

6- Failed SELECT File 

7- TERMINAL RESPONSE 

8- SELECT MF 

9- GET RESPONSE (6 Bytes) 
10-Failed SELECT File 
11-FETCH 

12-SELECT MF 

13-GET RESPONSE (6 Bytes) 

14-TERMINAL RESPONSE 




1-9FXX 

2- 91 XX 

3- Proactive Command: 

DISPLAY TEXT 

4- 9FXX 

5- 9000 

6- 9404 

7- 9000 

8- 9FXX 
9- 91 XX 

1 0-9404 

1 1 -Proactive Command: 

DISPLAY TEXT 

12-9FXX 
1 3-9000 
14-9000 
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6.3.4.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 



6.3.5 Exception Handling 

6.3.5.1 Hide Exceptions from the ME 

Test Area Reference: FWK_EXH_HEME 

6.3.5.1.1 Conformance Requirements 

6.3.5.1.1.1 Normal Execution 

• CRRNl: A toolkit applet may throw an exception, but this error will not be sent to the ME. 

NOTE: Because the behaviour of the SIM is not exactly defined for the above CRRN, there are no tests defined 
here yet. 

6.3.5.1.1.2 Parameters error 
No requirements. 

6.3.5.1.1.3 Context Errors 
No requirements. 

6.3.5.2 Interaction with Multiple Triggering 

Test Area Reference: FWK_EXH_IMTG 

6.3.5.2.1 Conformance Requirements 

6.3.5.2.1.1 Normal Execution: 

• CRRNl: An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same event. 



6.3.5.2.1.2 

No requirements. 

6.3.5.2.1.3 

No requirements. 

6.3.5.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_EXH_IMTG_1 .scr 
FWK_EXH_IMTG_1 .Java 
FWK_EXH_IMTG_1 .Idr 
FWK_EXH_IMTG_1 .clr 
FWK_EXH_IMTG_1 .par 
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6.3.5.2.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Load/install 2 toolkit applets registered to 

EVENT STATUS COMMAND, 

EVENT PROFILE DOWNLOAD, 

EVENT UNRECOGNIZED ENVELOPE, 

EVENT EVENT DOWNLOAD MT CALL, 

EVENT UNFORMATTED SMS PP ENV, 

EVENT UNFORMATTED SMS PP UPD, 

EVENT_UNFORMATTED_SMS_CB 

appletl: Priority= 0x01, 
applet2: Priority= 0x02, 
(i.e. appletl is triggered before applet2) 






1 


Status_Command is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




2 


Profile_Download is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




3 


UNRECOGNIZED_Envelope is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




4 


Event_Download_MT Call is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




5 


Unformatted_SMS_PP_Env is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




6 


Unformatted_SMS_PP_Upd is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




7 


Unformatted_SMS_CB is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 
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6.3.5.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5,6,7 



6.3.6 Framework Security Management 

Security Parameters 

The table that follows contains the security parameters that shall be used when the TS 23.048 [8]security is required in 
the test cases developed in the current subclause. 



Parameter 


Value in hexadecimal 


KIC 


11 


KID 


11 


CNTR 


00 00 00 00 01 


Key for ciphering 


01 41 42 7F DA E8 91 A7 


Key for RC/CC/DS 


01 23 45 67 89 AB CD EF 



If a parameter is not listed explicitly in the above table, the default values of subclause 4.7.3.1 apply. 

6.3.6.1 Input Data 

Test Area Reference: FWK FWS INDA 



6.3.6.1.1 



6.3.6.1.1.1 



Conformance Requirements 
Normal Execution 



• CRRNl : If the SIM receives an envelope APDU containing an SMS_PP_DATADOWNLOAD BER TLV 
formatted according to 3GPP TS 23.048 [8], the SIM Toolkit Framework shall verify the security of the SMS 
TPDU. 

• CRRN2: The toolkit applet will only be triggered if the TAR is known and the security verified. 

• CRRN3: If the SIM receives an envelope APDU containing an SMS_CB_DATADOWNLOAD formatted 
according to 3GPP TS 23.048 [8], the SIM Toolkit Framework shall verify the security of the cell broadcast 
page. 



6.3.6.1.1.2 

No requirements. 

6.3.6.1.1.3 

No requirements. 

6.3.6.1.2 
Test Script: 
Test Applet: 



Load Script: 



Parameters error 

Context Errors 

Test Area Files 

FWK_FWS_INDA_1 .scr 
FWK_FWS_INDA_1 .Java 
FWK_FWS_IND A_2.j ava 
FWK_FWS_IND A_3 .j ava 
FWK_FWS_IND A_4.j ava 
FWK FWS INDA l.ldr 
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Cleanup Script: 
Parameter File: 

Test Procedure 



FWK_FWS_INDA_1 .clr 
FWK_FWS_INDA_1 .par 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Framework checks the Cryptographic 
checksum and deciphers the data 

Appletl is loaded and installed 

1-Envelope (SMS-PP) formatted is sent to 

the SIM with this features: 

Ciphering; 

Cryptographic checksum; 

No proof of receipt; 

Data = 01 


1- Appletl is triggered. 




2 


Framework checks the Cryptographic 
checksum and deciphers the data 

Applet2 is installed 

1-Envelope (SMS-PP) formatted is sent to 
the SIM with this features: 

Ciphering; 

Cryptographic checksum; 

No proof of receipt; 

TAR of Appletl 

Data = 02 

2-Envelope (SMS-PP) 03.48 formatted is sent 

to the SIM with this features: 

No ciphering; 

No cryptographic checksum; 

No proof of receipt; 

TAR of Applet2 

Data = 03 


1- Appletl is triggered 
3- Applet2 is triggered 


2- The SIM answers to the 
Envelope with status words 
9000 

The SIM answers to the 
Envelope with status words 
9000 


3 


Envelope(SMS-PP) formatted with wrong 
cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 

No proof of receipt; 

TAR of Appletl 

Data = 04 


No applet is triggered 


1 - The SIM answers to the 
Envelope with status words 
9000 


4 


Framework checks the Cryptographic 
checksum and deciphers the data 

Applet3 is loaded and installed 

1-Envelope (SMS-CB) formatted is sent to 

the SIM with this features: 

Ciphering; 

Cryptographic checksum; 

No proof of receipt; 

Data = 01 


1- Applet3 is triggered. 


1 - The SIM answers to the 
Envelope with status words 
9000 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


5 


Triggering two different applets with different 
security on Envelope(SMS-CB) formatted 

Applet4 is installed 

1-Envelope (SMS-CB) formatted is sent to 

the SIM with this features: 

Ciphering; 

Cryptographic checksum; 

No proof of receipt; 

TAR of Applets 

Data = 02 

2-Envelope (SMS-CB) formatted is sent to 

the SIM with this features! 
No ciphering; 
Cryptographic checksum; 
No proof of receipt; 
TAR of Applet4 
Data = 03 


1 - Applets is triggered 
3- Applet4 is triggered 


2- The SIM answers to the 
Envelope with status words 
9000 

4- The SIM answers to the 
Envelope with status words 
9000 


6 


Envelope(SMS-CB) formatted with wrong 
cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 

No proof of receipt; 

TAR of Applets 

Data = 04 


No applet is triggered 


1 - The SIM answers to the 
Envelope with status words 
9000 



6.3.6.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 


CRRN2 


3,6 


CRRN3 


4,5,6 



6.3.6.2 Output Data 

Test Area Reference: FWK_FWS_OUDA 

6.3.6.2.1 Conformance Requirements 

6.3.6.2.1.1 Normal Execution 

• CRRNl: The SIM Toolkit Framework shall secure and send the response packet. 

6.3.6.2.1 .2 Parameters error 
No requirements. 

6.3.6.2.1.3 

No requirements. 

6.3.6.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Context Errors 

Test Area Files 

FWK_FWS_0UDA_1 .scr 
FWK_FWS_OUDA_l .Java 
FWK_FWS_OUDA_l .Idr 
FWK FWS OUDA l.clr 
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Parameter File: 



FWK_FWS_OUDA_l .par 



6.3.6.2.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report ; 

no security applied to proof of receipt 

Data in plain text = "APPLETl" 


The applet is triggered and sends a 
"Display Text" proactive command 
with the data received in the 
Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has no 
application data. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue a 
Display Text "APPLETl". 


2 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report; 

no security applied to proof of receipt 

Data in plain text = "APPLETl" 


The applet posts application data. It 
does not call the 
ProactiveHandler.sendO method 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 9000. 


3 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report; 

no security applied to proof of receipt 

Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.sendO method to 
send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


4 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report; 

proof of receipt shall be ciphered 

Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.sendO method to 
send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to issue 
the Display Text "TEST". 


5 


Envelope(SMS-PP) formatted 

The Terminal Profile command shall be 
issued with the facility "'9EXX' response 
code for SIM data download error" enabled 

The Envelope (SMS-PP) formatted has to be 

issued with the following features: 

No ciphering; 

Wrong Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report; 

no security applied to proof of 

receiptData in plain text = "TEST" 


No applet is triggered 


The SIM answers to the 
Envelope with status words 
9Exx and a PoR is retrieved 
with a GetResponse 
command. The Response 
Status Code Octet shall be 
'01'. 



6.3.6.2.4 



Test Coverage 



CRR Number 


Test Case Number 


GRRN1 


1,2,3,4,5 
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6.3.7 Envelope Response Posting 

6.3.7.1 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_ECCN 

6.3.7.1.1 Conformance Requirements 

6.3.7.1.1.1 Normal Execution 

• CRRNl: The SIM Toolkit Framework can't reply busy when an Envelope(Call Control) is sent to the SIM. 



6.3.7.1.1.2 

No requirements. 

6.3.7.1.1.3 

No requirements. 

6.3.7.1.2 
Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Area Files 

FWK_ERP_ECCN_1 .scr 
FWK_ERP_ECCN_1 .Java 
FWK_ERP_ECCN_2.java 
FWK_ERP_ECCN_3 .j ava 
FWK_ERP_ECCN_1 .Idr 
FWK_ERP_ECCN_1 .clr 
FWK_ERP_ECCN_1 .par 
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6.3.7.1.3 



Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Appletl is registered on the 

EVENT_CALL_CONTROL_BY_SIM, Applet2 is 

registered and triggered on the 

EVENT_MENU_SELECTION. 








1-Applet2 invokes the method send () and no 
fetch is performed 

2-Envelope (Call Control) is sent to the 
SIM 

3-Appletl calls the method 

EnvelopeResponseHandler .postASBERTLV () to 
change any incoming dialling number into 
+11 22 33 44. 


Applet2 is suspended 
Appletl is triggered. 


The SIIVI answer 9Fxx to the 
Envelope(Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 
The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


Applet2's execution shall continue. 






6-Delete Appletl s Applet2 








7-Install Applet3 






2 


Applet3 is registered on both the events 

EVENT CALL CONTROL BY SIM and 

EVENT_MENU_SELECTION. 

l-Envelope Menu Selection is sent to the 
SIM. 


Applets is triggered on the 
EVENT_MENU_SELECTION 






2-Applet3 invokes the method send () and no 
fetch is performed) 


Applets is suspended on the sendQ 
method 






3-Envelope (Call Control) is sent to the 
SIM 

4-Applet3 calls the method 

EnvelopeResponseHandler .postASBERTLV to 
change any incoming dialling number into 
+11 22 33 44. 


Applets is triggered on the 
EVENT CALL CONTROL BY SI 

M. 


The SIIVI answer 9Fxx to the 
Envelope(Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 




5-A Fetch command is sent to the SIM 




The SIM answers to the Get 
Response command with 
status words 91 XX. 




6-A Terminal Response command is sent to 
the SIM 


The AppletS's execution shall 
continue. 
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6.3.7.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_EMCN 



6.3.7.2.1 



6.3.7.2.1.1 



Conformance Requirements 
Normal Execution 



• CRRNl: The SIM Toolkit Framework can't reply busy when an Envelope(MO-Short Message Control) is sent to 
the SIM. 



6.3.6.2.1.2 

No requirements. 

6.3.6.2.1.3 

No requirements. 

6.3.7.2.2 
Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Area Files 

FWK_ERP_EMCN_1 .scr 
FWK_ERP_EMCN_1 .Java 
FWK_ERP_EMCN_2.j ava 
FWK_ERP_EMCN_3 .j ava 
FWK_ERP_EMCN_1 .Idr 
FWK_ERP_EMCN_1 .clr 
FWK_ERP_EMCN_1 .par 
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6.3.7.2.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Appletl is registered on the 

EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM; Applet2 is registered and triggered on 

the EVENT MENU SELECTION. 



1-Applet2 invokes the method send () and no 
fetch is performed) 

2-Envelope (MO-SM control) is sent to the 

SIM 

3-Appletl calls the method 

EnvelopeResponseHandler .postASBERTLV () to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
Service Center into +11 22 33 44 



Applet2 is suspended 
Applet 1 is triggered. 



4-A Fetch command is sent to the SIM 

5-A Terminal Response command is sent to 
the SIM 



6-Delete Appletl & Applet2 
7-Install Applet3 



The SIIVI answers 9Fxx to 
the Envelope{IVIO-Short 
IVIessage Control) 



The 

TP_Destination_Address is 
retrieved with a 
GetResponse command. 

The SIIVI answers to the Get 
Response command with 
status words 91 xx. 



The Applet's execution shall 
continue. 



Applet 3 is registered on both the events 

EVENT_MO_SHORT_MESSAGE_CONTROL_B 

Y_SIM and EVENT_MENU_SELECTION. 

1-Applet3 invokes the method send () and no 
fetch is performed) 



2-Envelope (MO-SM control) is sent to the 

SIM 

3-Applet3 calls the method 

EnvelopeResponseHandler .postASBERTLV to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
Service Center into +11 22 33 44. 



Applets is suspended on the sendQ 
method 



Applets is triggered on the 
EVENT_MO_SHORT_MESSAGE_ 
CONTROL BY SIM. 



The SIM answers 9Fxx to 
the Envelope{MO-Short 
Message Control) 

The 

TP_Destination_Address is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 



4-A Fetch command is sent to the SIM 

5-A Terminal Response command is sent to 
the SIM 



The AppletS's execution shall 
continue. 
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6.3.7.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_ERP_EUEN 

6.3.7.3.1 Conformance Requirements 

6.3.7.3.1.1 Normal Execution 

• CRRN 1 : The EnvelopeResponseHandler is available for the E VENT_UNRECOGNIZED_EN VELOPE. 



6.3.7.3.1.2 

No requirements. 

6.3.7.3.1.3 

No requirements. 

6.3.7.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.7.3.3 



Parameters error 

Context Errors 

Test Area Files 

FWK_ERP_EUEN_1 .scr 
FWK_ERP_EUEN_1 .Java 
FWK_ERP_EUEN_1 .Idr 
FWK_ERP_EUEN_1 .clr 
FWK_ERP_EUEN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


An applet triggered on the 


The post() method returns no 


The SIM answers to the 




EVENT UNRECOGNIZED ENVELOPE calls the 


exception 


Envelope with status words 




EnvelopeResponseHandler.postQ method 




9Fxx. The data retrieved 
with the GetResponse 
command are the ones 
posted by the applet. 



6.3.7.3.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.8 Toolkit Installation 
6.3.8.1 Timers Allocation 

Test Area Reference: FWK_TIN_TMAL. 
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6.3.8.1.1 Conformance Requirements 

6.3.8.1.1.1 Normal execution 

• CRRNl: One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit applet. 

6.3.8.1.1.2 Parameters error 
No requirements. 

6.3.8.1.1.3 Context errors 

• CRRCl: Allocated timers shall not exceed the maximum number of timers allowed for this applet instance 
defined during installation. 

• CRRC2: The total number of timers allocated for all the applets shall not exceed 8. 



6.3.8.1.2 
Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.1.3 



Test suite files 

FWK_TIN_TMAL_1 .scr 
FWK_TIN_TMAL_1 .Java 
FWK_TIN_TMAL_2.j ava 
FWK_TIN_TM AL_3 .j ava 
FWK_TIN_TMAL_1 .Idr 
FWK_TIN_TMAL_1 .clr 
FWK_TIN_TMAL_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


More than 8 timers at the 

instantiation of appletl: check 

that appletl is not installed or 

that it is not possible to 

allocate more than 8 timers . 

Install for install of appletl with 
maximum 9 timers allocated. 

appletl is triggered: we allocate 9 timers 
appletl is selected 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 
only on the 9* ailocateTimer() 


The SIM answers to the 

Envelope with status words 

90 00 

2 behaviours may be 

expected : 

1. appletl is not found, 

status word 6X XX 

2. appletl has been 

installed and only 8 timers 

are allocated 




Reset the card and delete instance of appletl 






2 


Good installation of applet2 

Install for install of applet2 (maximum 4 
timers allocated) . 




The SIM answers to the 

Envelope with status words 

90 00 


3 


Allocate 4 timers 
Applet2 


No exception shall be thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Allocate one more timer 
Applet2 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




5 


Good installation of applets 

Install for install of applets (maximum 8 
timers allocated) . 




The SIM answers to the 

Envelope with status words 

90 00 


6 


Allocate 4 timers 
Applets 


No exception shall be thrown. 




7 


Allocate one more timer 
Applets 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




8 


Check that each timerld (allocated by applet2 

and applets) is between 1 and 8 and is different 

from each other 







6.3.8.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,8 


CI 


1,7 


C2 


4,5,6 



6.3.8.2 Item Identifier 

Test Area Reference: FWK_TIN_ITID 



6.3.8.2.1 



6.3.8.2.1.1 



Conformance Requirements 
Normal execution 



• CRRNl: If the requested item identifier in the range [1-127] is not already allocated, then this item identifier 
shall be allocated to the current applet. 

• CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 

6.3.8.2.1 .2 Parameters error 

• CRRPl: If the requested item identifier is in the range [128,255], then the card shall reject the install command. 

6.3.8.2.1.3 Context errors 

• CRRCl: If the requested item identifier in the range [1-127] is already allocated, then the card shall reject the 
install command. 



6.3.8.2.2 
Test Script: 
Test Applet: 



Test suite files 

FWK_TIN_ITID_l.scr 
FWK_TIN_ITID_1 .Java 
FWK_TIN_ITID_2.j ava 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.2.3 



FWK_TIN_ITID_3 .j ava 
FWK_TIN_ITID_l.ldr 
FWK_TIN_ITID_l.clr 
FWK_TIN_ITID_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Bad installation of appletl 

Install for install of appletl. The 
following parameters item Id equal to 128 

appletl is selected 




appletl is not found, status 
word 6XXX 


2 


Good installation of appletl 

Install for install of appletl . item Id = 
1 for the first menu and 127 for the 
second one 

A Terminal Profile is sent to the card 
with only PROFILE_DOWNLOAD, 
SMS_PP_DOWNLOAD, MENU_SELECTION, 
SET_UP_MENU and COMMAND_RESULT facilities. 




The SIM answers to the 

Envelope with status words 

91 XX to send back to the ME 

the 2 new menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/127/menu12 


3 


Bad installation of applet2 

Item identifier already allocated 

Install for install of applet2 . 
item Id = 127 

applet2 is selected 




applet2 is not found, status 
word 6X XX 


4 


Good installation of applet2 

Install for install of applet2 . 
item Id = 




The SIM answers to the 

Envelope with status words 

91 XX to send back to the ME 

the 3 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 


5 


Good installation of applets 

Install for install of applets, 
item Id = 




The SIM answers to the 

Envelope with status words 

91 XX to send back to the ME 

the 4 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 
04/129/menu31 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


Good delete and installation of applet2 

Delete instance of applet2 

Perform a RESET and a Terminal Profile 
with the facilities of PROFILE_DOWNLOAD, 
SMS-PP_DATA_DOWNLOAD, MENU_SELECTION, 
COMMAND_RESULT and SET_UP_MENU 

Install for install of applet2 . 
item Id = 




The SIM answers to the 

Terminal Profile with status 

words 91 XX to send back to 

the ME the 3 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/129/menu31 

The SIM answers to the 

Envelope with status words 

91 XX to send back to the ME 

the 4 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 
04/129/menu31 



6.3.8.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


4,5,6 


PI 


1 


CI 


3 



6.3.8.3 Item Position 

Test Area Reference: FWK_TIN_ITPO 

6.3.8.3.1 Conformance Requirements 

6.3.8.3.1.1 Normal execution 

• CRRNl: The position of the new menu entries is an absolute position among the existing ones. 

• CRRN2: If the position identifier is OOh, the menu shall have the last position. 

6.3.8.3.1 .2 Parameters error 
No requirements. 

6.3.8.3.1.3 

No requirements. 

6.3.8.3.2 
Test Script: 
Test Applet: 



Context errors 

Test suite files 

FWK_TIN_ITPO_l.scr 
FWK_TIN_ITPO_l .Java 
FWK_TIN_ITPO_2.java 
FWK_TIN_ITPO_3 .j ava 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.3.3 



FWK_TIN_ITPO_l.ldr 
FWK_TIN_ITPO_l.clr 
FWK_TIN_ITPO_l .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of appletl 

Perform Install for install of 
appletl . Position/Itemid 
01/01 
02/02 

A Terminal Profile is sent to the card 




The menus are 
(position/item Id/text) 
01/01/menu11 
02/02/menu12 


2 


Installation of applet2 

Perform Install for install of applet2 . 

Position/ I temid 

03/03 

04/04 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 


3 


Installation of applet3 

Perform Install for install of applet3. 

Position/ Itemid 

00/05 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 5 menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 

05/05/menu31 



6.3.8.3.4 



Test Coverage 



NOTE: As Item Position management is not fully specified in the 3GPP TS 43.019 [7] or 3GPP TS 23.048 [8] all 
possible tests cannot be performed. 



CRR number 


Test case number 


N1 


1,2 


N2 


3 



6.3.8.4 Maximum Text Length for a menu entry 

Test Area Reference: FWK_TIN_MLME 

6.3.8.4.1 Conformance Requirements 

6.3.8.4.1.1 Normal execution 

• CRRNl: The maximum length of item text string is defined at the installation of the toolkit applet. 
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6.3.8.4.1.2 



Parameters errors 



• CRRPl : If initMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 

• CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolkitException ALLOWED_LENGTH_EXCEEDED is thrown. 



6.3.8.4.1.3 

No requirements. 

6.3.8.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.4.3 



Context errors 

Test suite files 

FWK_TIN_MLME_Lscr 
FWK_TIN_MLME_1 .Java 
FWK_TIN_MLME_1 .Idr 
FWK_TIN_MLME_1 .clr 
FWK_TIN_MLME_1 .par 

Test Procedure 



Id 


Description 


API / Framework Expectation 


APDU Expectation 


1 


Installation of applet with 2 menus not 
exceeding the maximum text length 

Install one applet with 2 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl " , "MenuEntry2" 
Offset = 
Length =10 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 






2 


InitMenuEntry with a too large length 

initMenuEntry with length equal to 11 

MenuEntry = " MenuEntryOS" 

Offset = 

Length =11 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 




3 


InitMenuEntry with a right length 

InitMenuEntry with length parameter equal 

to 10 

MenuEntry = " MenuEntryS" 

Offset = 

Length =10 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 




a SET UP MENU (2 items) 
is issued with TLV item 
length equal to 1 1 (Identifier 
-1- Text string of item) 
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Id 


Description 


API / Framework Expectation 


APDU Expectation 


4 


ChangeMenuEntry with a right length 

Appletl is triggered by a 

EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 

parameter equal to 10 

Id = '01' 

MenuEntry = "MenuEntry 4" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 

Return from processToolkit 




a SET UP MENU (2 items) 
is issued witli TLV item 
lengtli equal to 1 1 (Identifier 
+ Text string of item) 


5 


ChangeMenuEntry with a too large length 

Appletl is triggered by a 

EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 

parameter equal to 11 

Id = '02' 

MenuEntry = "MenuEntryOS" 

Offset = 

Length = menuEntry . length 

NextAction = 

HelpSupported = false 

IconQualif ier = 

Iconldentif ier = 

Return from processToolkit 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 


Shall not receive a SET UP 
IVIENU different from the 
previous one 



6.3.8.4.4 



Test Coverage 



CRR number 


Test case number 


CRRN1 


1,3,4 


CRRP1 


2 


CRRP2 


5 



6.3.8.5 Maximum number of menu entries 

Test Area Reference: FWK TIN NBME 



6.3.8.5.1 



6.3.8.5.1.1 



Conformance Requirements 
Normal execution 



CRRNl: The maximum number of menu entries is defined at the installation of the toolkit applet and can be the 
maximum number of successful invocations of the method initMenuEntry . 



6.3.8.5.1.2 



Parameters errors 



CRRP 1 : If the menu entry cannot be initialized (e.g. no more item data in applet loading parameter), a 
ToolkitException with the REGISTRY_ERROR reason code is thrown. 



6.3.8.5.1.3 

No requirements. 

6.3.8.5.2 

Test Script: 



Context errors 

Test suite files 

FWK TIN NBME l.scr 
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Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.5.3 



FWK_TIN_NBME_1 .Java 
FWK_TIN_NBME_2.j ava 
FWK_TIN_NBME_1 .Mr 
FWK_TIN_NBME_1 .clr 
FWK_TIN_NBME_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is '3', defined at the 
install (install) command. 

InitMenuEntry for each menu entry allowed 
(3 times) 

MenuEntry = "menul", "menu2", "menu3" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No Exception is tlirown 




2 


init of a 4''' menu 

InitMenuEntry one more time 
MenuEntry = "menu4" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


Tooll<itException 
REGISTRY_ERROR is tlirown 


SET UP MENU (3 items) is 
issued with TLV item length 
equal to 6 (identifier + Text 
string of item) 


3 


Installation of 2"° applet with menu 

Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

InitMenuEntry once 
MenuEntry = "menul" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


Tooll<itException 
REGISTRY_ERROR is tlirown 


Shall not receive a SET UP 
IVIENU different from the 
previous one 



6.3.8.5.4 



Test Coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2,3 



6.3.8.6 Access Domain 

Test Area Reference: FWK_TIN_ACDO 
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6.3.8.6.1 



6.3.8.6.1.1 



Conformance Requirements 



Normal execution 



CRRNl: The Access Domain parameter indicates the mechanism used to control the applet instance access to 
the GSM file System ('00' means full access to the GSM File System, 'FF' means no access to the GSM File 

System). 



6.3.8.6.1.2 



Parameters errors 



• CRRPl : If the Access Domain Parameter requested is not supported, the card shall return the Status Word 
'6A80', incorrect parameters in data field, to the Install(Install) command. 

• CRRP2: If an applet with Access Domain Parameter 'FF' (i.e. No Access to the GSM File System) tries to access 
a GSM file (e.g. invoke the updateBinary(..) method) the framework shall throw a SIMViewException with a 
AC_NOT_FULFILLED reason. 



6.3.8.6.1.3 

No requirements. 

6.3.8.6.2 
Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.6.3 



Context errors 

Test suite files 

FWK_TIN_ACDO_l .scr 
FWK_TIN_ACDO_l .Java 
FWK_TIN_ACDO_2.java 
FWK_TIN_ACDO_3 .j ava 
FWK_TIN_ACDO_l .Idr 
FWK_TIN_ACDO_l .clr 
FWK_TIN_ACDO_l .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Install (install) appletl with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 

Install (install) applet2 with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is ' FF ' 
(No access to the GSM File System) 

Install (install) applets with: 

- Length of Access Domain field value is 
'1' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



readBinary/readRecord method with full 
Access Domain Parameter 



1- Select EF-TARU file whose Read access 
condition is ALWAYS 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

2- Select EF-SMS file whose Read access 
condition is CHVl 

Perform the readRecord method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp = abRead[] 

respOffset = 

respLength = 3 

3- Select EF-TRAC file whose Read access 
condition is CHV2 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Read access 
condition is ADMO 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 

5- Select EF-TNR file whose Read access 
condition is NEVER 

Perform the readBinary method: 
fileOffset = 
resp = abRead[] 
respOffset = 
respLength = 3 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



updateBlnary/updateRecord method with full 
Access Domain Parameter 

For each case, send an Envelope that 
triggers the applet with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

1- Select EF-TNR file whose Update access 
condition is ALWAYS 

Perform the updateBinary method: 

fileOffset = 

resp = abUpdate [FFFFFF] 

respOffset = 

respLength = 3 

2- Select EF-SMS file whose Update access 
condition is CHVl 

Perform the updateRecord method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = Oresp = abUpdate [ ] 

respOffset = 

respLength = 3 

3- Select EF-FDN file whose Update access 
condition is CHV2 

Perform the updateBinary method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

resp = abUpdate [ ] 

respOffset = 

respLength = 3 

4- Select EF-SUME file Update access 
condition is ADMO 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [ ] 
respOffset = 
respLength = 3 

5- Select EF-TNU file whose Update access 
condition is NEVER 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [ ] 
respOffset = 
respLength = 3 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is thrown 



invalidate method with full Access Domain 
Parameter 



1- Select EF-TNR file whose Invalidate 
access condition is ALWAYS 

Perform the invalidate method 

2- Select EF-TIAC file whose Invalidate 
access condition is CHVl 

Perform the invalidate method 

3- Select EF-ADN file whose Invalidate 
access condition is CHV2 

Perform the invalidate method 

4- Select EF-SUME file Invalidate access 
condition is ADMO 

Perform the invalidate method 

5- Select EF-CNIV file whose Invalidate 
access condition is NEVER 

Perform the invalidate method 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



rehabilitate method with full Access Domain 
Parameter 



1- Select EF-TNR file whose Rehabilitate 
access condition is ALWAYS 

Perform the rehabilitate method 

2- Select EF-IMSI file whose Rehabilitate 
access condition is CHVl 

Perform the rehabilitate method 

3- Select EF-ADN file whose Rehabilitate 
access condition is CHV2 

Perform the rehabilitate method 

4- Select EF-SUME file Rehabilitate access 
condition is ADMO 

Perform the rehabilitate method 

5- Select EF-CNRI file whose Rehabilitate 
access condition is NEVER 

Perform the rehabilitate method 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is thrown 



increase method with full Access Domain 
Parameter 



1- Select EF-CNR file whose Increase 
access condition is ALWAYS 
Perform the increase method: 

incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

2- Select EF-ACM file whose Increase 
access condition is CHVl 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

3- Select EF-CIAC file whose Increase 
access condition is CHV2 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

4- Select EF-CIAA file Increase access 
condition is ADMO 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

5- Select EF-CNU file whose Increase 
access condition is NEVER 

Perform the increase method 



1 to 4- no exception is tlirown 



5- SIMViewException 

AC NOT FULFILLED is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


readBinary method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-TARU file whose Read access 

condition is ALWAYS 

Perform the readBinary method: 

fileOffset = 

resp = abRead[] 

respOffset = 

respLength = 3 

t 


SIMViewException 
AC_NOT_FULFILLED is thrown 




7 


updateRecord method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SMS file whose Update access 

condition is CHVl 

Perform the updateRecord method: 

fileOffset = 

resp = abUpdate [ ] 

respOffset = 

respLength = 3 


SIMViewException 
AC_NOT_FULFILLED is thrown 




8 


invalidate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-ADN file whose Invalidate access 

condition is CHV2 

Perform the invalidate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




9 


rehabilitate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SUME file Rehabilitate access 

condition is ADMO 

Perform the rehabilitate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




10 


increase method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-CNR file whose Increase access 

condition is NEVER 

Perform the increase method 


SIMViewException 
AC_NOT_FULFILLED is thrown 

Applet2 finalizes 
Applets restore EF-SUME 





6.3.8.6.4 Test Coverage 

NOTE: As Item Position management is not fully specified in the 3GPP TS 43.019 [7] or 3GPP TS 23.048 [8] all 
possible tests cannot be performed. 
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CRR number 


Test case number 


CRRN1 


1,2,3,4,5 


CRRP1 


Not tested 


CRRP2 


6,7,8,9, 10 



6.3.8.7 Priority Level 

Test Area Reference: FWK TIN PRLV 



6.3.8.7.1 



6.3.8.7.1.1 



Conformance Requirements 
Normal execution 



• CRRNl: The priority specifies the order of activation of an applet compared to the other applet registered to the 
same event ('01': Highest priority level, 'FF' : Lowest priority level). 

• CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets are 
activated according to their installation date (i.e. the most recent applet is activated first). 



6.3.8.7.1.2 

No requirements. 

6.3.8.7.1.3 

No requirements. 

6.3.8.7.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.7.3 



Parameters errors 

Context errors 

Test suite files 

FWK_TIN_PRLV_x.scr, x from 1 to 12 

FWK_TIN_PRLV_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB 

FWK_TIN_PRLV_x.ldr, x from 1 to 12 

FWK_TIN_PRLV_x.clr, x from 1 to 12 

FWK_TIN_PRLV_x.par, x from 1 to 12, 8A, SB, 9A, 9B, lOA, lOB 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





All applets are registered on an 
EVENT UNFORMAI 1 ED SMS PP ENV event 






1 


Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level ' 2 ' and applet2 with priority level 
' 1 ' , from package fwk_tin_prlv_l . 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level ' 1 ' and applet2 with priority level 
' 2 ' , from package fwk_tin_prlv_2 . 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: appletl is 
triggered before applet2. 




3 


Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '80' and applet2 with priority level 
'7F', from package fwk_tin_prlv_3 . 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




4 


Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '7F' and applet2 with priority level 
'80', from package fwk_tin_prlv_4 . 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




5 


Trigger 3 applets with the same Priority Level 

Install (install) applet 1, 2, 3 in this 
order with same priority level from 
package fwk_tin_prlv_5 . 

Send an Envelope that triggers the 3 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages. 


A static variable is used to validate 
triggering order: applets is 
triggered before applet2, and 
applet2 is triggered before appletl . 




6 


Trigger 2 applets from 2 classes, with 2 
different Priority Level 

Install (install) appletl from class A 
with priority level '2' 

Install (install) applet2 from class B 
with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable Is used to validate 
triggering order: applet2 is 
triggered before appletl 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


7 


Trigger 2 applets from 2 classes, with the same 
Priority Level 

Install (install) appletl from class A 
with priority level ' 1 ' 

Install (install) applet2 from class B 
with priority level ' 1 ' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

Install package fwk_tin_prlv_8 . 
Install (install) appletl from package 
fwk_tin_prlv_8A with priority level '2' 
Install (install) applet2 from package 
fwk_tin_prlv_8B with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances ad packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




9 


Trigger 2 applets from 2 packages, with the 
same Priority Level 

Install package fwk_tin_prlv_9 . 
Install (install) applets 1 from package 
fwk_tin_prlv_9A and applet2 from package 
fwk_tin_prlv„9B in this order, with same 
priority level 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 





£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



382 



ETSI TS 151 013 V4.1.0 (2003-12) 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



10 



Trigger 4 applets from 2 packages 

l-Install packages fwk_tin_prlv_10, 
fwk_tin_prlv_10A and fwk_tin_prlv_10B . 
Install (install) 2 applets 1 then 2 from 
package fwk_tin_prlv_10A, with 
respectively priority levels 1 and 2 . 

Send an Envelope that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 



2- Install (install) 2 applets 3 then 
from package fwk_tin_prlv_10B, with 
respectively priority levels 1 and 2 . 

Send an Envelope that triggers the 4 
applets . 

Delete applets instances and packages 



1- A static variable is used to 
validate triggering order: appletl is 
triggered before applet2 



2- Applets is triggered before 
applets 1, 4, then 2. 



11 



Trigger 4 applets with the same Priority Level 

then delete them one after another and trigger 

them each time 

1- Install (install) appletl, 2, 3, 4 in 
this order with same priority level from 
package fwk_tin_prlv_ll . 

Send an Enveloppe that triggers the 4 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 



Delete applet instance 4 

2- Send an Enveloppe that triggers the 3 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 



Delete applet instance 3 

3- Send an Enveloppe that triggers the 2 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 



Delete remaining applet instances and 
packages 



1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3,2,1. 



2- Applets are triggered In order 3, 
2, 1. 



3- Applets are triggered in order 2, 
1. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Trigger 5 applets with different Priority Levels, 
alternating install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

Send an Enveloppe that triggers the 4 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 








2- Delete applet instance 1 and install 
(install) applets with priority level 2 


1 - A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 






Send an Enveloppe that triggers the 4 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 


2- Applets are triggered in order 3, 






3- Re-install (install) appletl with 
priority level 1 


5,4,2 






Send an Enveloppe that triggers the 5 
applets with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 


3- Applets are triggered in order 1 , 
3, 5, 4, 2 





6.3.8.7.4 



Test Coverage 



CRR number 


Test case number 


CRRN1 


1,2,3,4,6,8, 10, 12 


CRRN2 


5,7,9, 11 



6.3.9 File System Context 
6.3.9.1 Initial Context 

Test Area Reference: FWK_FSC_INIT 

6.3.9.1.1 Conformance Requirements 

6.3.9.1.1.1 Normal Execution 

• CRRN 1 : At the invocation of the processToolkit method of a toolkit applet, the current file is the MF. 

6.3.9.1 .1 .2 Parameters errors 
No requirements. 

6.3.9.1.1.3 

No requirements. 

6.3.9.1.2 
Test Script: 



Context errors 

Test Suite Files 

FWK FSC INIT l.scr 
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Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 
6.3.9.1.3 



FWK_FSC_INIT_1 .Java 

FWK_FSC_INIT_2.java 

FWK_FSC_INIT_l.ldr 

FWK_FSC_INIT_l.clr 

FWK_FSC_INIT_2.clr 

FWK_FSC_INIT_l.par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


MF is the selected DF in processToolkit() 

An ENVELOPE APDU containing a formatted 
SMS PP for Applet 1 is issued to the SIM 
byte [ ] fci = new byte [10] 
fciOffset = 
fclLength = 7 
status 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 




2 


No EF is selected 

rehabilitate () 


SIMView exception shall be thrown 
with reason NO EF SELECTED 




3 


MF is selected even when an applet triggered 
before selected any other file... 

Applets 1 and 2 register to 

EVENT_DOWNLOAD_USER_ACTIVITY. Applet 1 has 
higher priority than Applet 2 . 

An ENVELOPE "EVENT - USER ACTIVITY" is 
sent to the SIM 

1 - Applet 1 : 

- is triggered by 
event_event_download_user_activity 

- selects DF_GSM and EF_IMSI 

2 - Applet 2 : 

- is triggered by 

event_event_download_user_activity 
fciOffset = 

fclLength = 7 
status 

3 - rehabilitate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 

3 - SIMView exception shall be 
thrown with reason 
NO_EF_SELECTED 





6.3.9.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3 



6.3.9.2 Context Preservation (current file) 

Test Area Reference: FWK_FSC_CUFI 



6.3.9.2.1 



6.3.9.2.1.1 



Conformance Requirements 
Normal execution 



• CRRNl: When calling the method select (), the current files (file context) of any other applets shall not be 
changed (see 3GPP TS 43.019 [7] - subclause 5.2). 

• CRRN2: The select() methods select a file without changing the current file of any other applet or of the 
subscriber session. 
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• CRRN3: After invocation of ProactiveHandler.send() method: the current file context of the toolkit applet is 
unchanged (see 3GPP TS 43.019 [7] - subclause 5.2.). 



6.3.9.2.1.2 

No requirements. 

6.3.9.2.1.3 

No requirements. 

6.3.9.2.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 
6.3.9.2.3 



Parameters errors 

Context errors 

Test Suite Files 

FWK_FSC_CUFI_l.scr 
FWK_FSC_CUFI_1 .Java 
FWK_FSC_CUFI_2.j ava 
FWK_FSC_CUFI_l.ldr 
FWK_FSC_CUFI_l.clr 
FWK_FSC_CUFI_2.clr 
FWK_FSC_CUF1_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No change to file context by another applet 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV . 
Applet2 registers to 
EVENT_CALL_CONTROL_BY_SIM 

1 - Applet 1 : 

- is triggered by a formatted SMS 

- selects DF_SIMTEST and EF_TARU 

- fileOffset = 0; dataLength = 2; 
dataOffset = 0; 

- buffer = {OxCA, OxFE } 

- updateBinary () : first 2 bytes of 
EF_TARU are written as ' CA FE ' . 

- issues a proactive command "Get Inkey" . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 

- selects DF_TELECOM and EF_ADN . 

3 - The terminal response for Get Inkey 
reactivates Applet 1 : 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


A GET INKEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


No change to file context by subscriber 
session 

1 - Applet 1 

- issues a proactive command "Get Inkey" . 

2 - Subscriber session selects DF_TELECOM 
and EF_ADN. 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


No change by applet of subscriber session 
context 

1 - Applet 1 : 

- selects DF_SIMTEST and EF_TNU 

- issues a proactive command "Get Inkey" . 

2 - subscriber session reads record 1 of 
current file (shall be EF_ADN) 

3 - The terminal response for Get Inkey 
reactivates Applet 1, which terminates 
execution 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 

2 - READ RECORD 
absolute number 1 shall 
read "FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF" (from 
EFadn) 



6.3.9.2.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


1,2,3 


CRRN3 


1,2 



6.3.9.3 Context Preservation (current record pointer) 

Test Area Reference: FWK_FSC_CURE 

6.3.9.3.1 Conformance Requirements 

6.3.9.3.1.1 Normal execution 

• CRRNl: When the seek method is called by one applet, the record pointer of any other applet is not changed. 

• CRRN2: updateRecord: the current record pointer of other applets / subscriber shall not be changed in case of 
linear fixed EF 

• CRRN3: updateRecord: the record pointer of a cyclic EF shall be changed for all other applets / subscriber to the 
record number 1 . 

• CRRN4: readRecord: read data bytes of the linear fixed or cyclic EF currently selected by the applet without 
changing the current record pointer of any other applet / subscriber. 

• CRRN5: increase: the last updated record of the cyclic EF currently selected becomes record number 1 for every 
other applet and subscriber session. 



6.3.9.3.1.2 

No requirements. 



Parameters errors 
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6.3.9.3.1.3 

No requirements. 

6.3.9.3.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 
6.3.9.3.3 



Context errors 

Test Suite Files 

FWK_FSC_CURE_1 .scr 
FWK_FSC_CURE_1 .Java 
FWK_FSC_CURE_2.j ava 
FWK_FSC_CURE_1 .Idr 
FWK_FSC_CURE_1 .clr 
FWK_FSC_CURE_2.clr 
FWK_FSC_CURE_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Seek without affecting another record pointer 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV 
Applet 2 registers to 
EVENT_CALL_CONTROL_B Y_S IM 

1 - Applet 1 : 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL event 

- selects DF_SIMTEST and EF_LARU 

- performs a seek of pattern {0x55} from 
beginning forward, which finds record 1 . 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing { OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


updateRecord in linear fixed EF without 
affecting current pointer of others 

1 - Applet 1 : 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF^SIMTEST and EF^LARU 

- updates record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1 : 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing { OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


readRecord in linear fixed EF without affecting 
current pointer of others 

1 - Applet 1 : 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- reads record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1 : 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 



6.3.9.3.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


2 


CRRN3 


not tested (see note) 


CRRN4 


3 


CRRN5 


not tested (see note) 


NOTE: These requirements have not been tested 
because of an inconsistent behaviour in 
3GPP TS 43.019 [7], which is foreseen to be 
corrected in future releases. 
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6.3.1 Other parts transferred to framework from API 
6.3.1 0.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: FWK API HEPO 



6.3.10.1.1 



6.3.10.1.1.1 



Conformance Requirement: 
Normal execution 



CRRNl: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 



6.3.10.1.1.2 
No requirements. 

6.3.10.1.1.3 
No requirements. 

6.3.10.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.10.1.3 



Parameters errors 

Context errors 

Test suite files 

FWK_API_HEPO_l .scr 
FWK_API_HEPO_l .Java 
FWK_API_HEPO_l .Idr 
FWK_API_HEPO_l .clr 
FWK_API_HEPO_l .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


EnvelopeHandler.getTheHandler and store it in 
a static field of the toolkit applet 


SecurityException is thrown 




2 


EnvelopeHandler.getTheHandler and store it in 
a field of the toolkit applet 


SecurityException is tlirown 




3 


EnvelopeResponseHandler.getTheHandlerand 
store it in a static field of the toolkit applet 


SecurityException is tlirown 




4 


EnvelopeResponseHandler.getTheHandlerand 
store it in a field of the toolkit applet 


SecurityException is thrown 




5 


ProactiveHandler.getTheHandler and store it in 
a static field of the toolkit applet 


SecurityException is thrown 




6 


ProactiveHandler.getTheHandler and store it in 
a field of the toolkit applet 


SecurityException is thrown 




7 


Build and send a DISPLAY TEXT command to 

be able to get the reference of the 

ProactiveReponseHandler 

ProactiveResponseHandler.getTheHandlerand 
store it in a static field of the toolkit applet 


SecurityException is thrown 


Proactive command fetched 
and terminal response is 
issued 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


8 


ProactlveResponseHandler.getTheHandler and SecurityException is thrown 
store It in a field of the toolkit applet 





6.3.10.1.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


3,4 


N3 


5,6 


N4 


7,8 



6.3.10.2 Transaction 

Test Area Reference: FWK_API_TRAN 

6.3.10.2.1 Conformance Requirement: 

6.3.10.2.1.1 Normal execution 

• CRRNl: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted. 



6.3.10.2.1.2 
No requirements. 

6.3.10.2.1.3 
No requirements. 

6.3.10.2.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.10.2.3 



Parameters errors 

Context errors 

Test suite files 

FWK_API_TRAN_l.scr 
FWK_API_TRAN_1 .Java 
FWK_API_TRAN_1 .Idr 
FWK_API_TRAN_1 .clr 
FWK_API_TRAN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Verify that transaction is aborted when a 
proactive command is sent 

Initialize a byte field with 0x05 

Build a display text proactive command. 

beginTransactionO 

Update the byte with 0x02 

send the proactive command 

Verify that the byte value is 0x05 
JCSystem.getTransactionDepthO 


Shall return 


Proactive command fetched 
and terminal response is 
issued 
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6.3.10.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6.3.1 0.3 Timer Id between Applets 

Test Area Reference: FWK API TMID 



6.3.10.3.1 

6.3.10.3.1.1 
No requirements. 

6.3.10.3.1.2 
No requirements. 

6.3.10.3.1.3 



Conformance Requirement: 
Normal execution 

Parameters errors 

Context errors 



• CRRCl: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with 
INVALID_TIMER_ID reason if the timer is valid but isn't allocated to this applet. 



6.3.10.3.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.10.3.3 



Test suite files 

FWK_API_TMID_1 .scr 
FWK_API_TMID_1 .Java 
FWK_API_TMID_1 .Mr 
FWK_API_TMID_1 .clr 
FWK_API_TMID_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


During installation : 

First instance allocate a timer and store the 

returned value in a static field. 

Second instance allocate a timer. 








Trig second instance and try to releaseTimer() 


releaseTimerO shall throw a 






with the static field value. 


ToolkitException with 
INVALID_TIMERJD reason 





6.3.10.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 
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Annex A (normative): 

Class and Methods AID numbering and acronyms 



A.1 Sim. access 



Class Name 


Acronyms 


Numbering on 5 bits 


SIMView 


svw 


00001 


SIMSystem 


SSY 


00010 


SIMViewException 


SVE 


00011 



A.1.1 SllVIView methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static final Constants 




000001 


short increase {byte [ ] incr, short incrOffset, byte[] 
resp, short respOffset) 


INCR_BS_BS 


000010 


void invalidate () 


INVL 


000011 


void readBinary (short fileOffset, byte[] resp, short 
respOffset, short respLength) 


REDBS_BSS 


000100 


short readRecord (short recNumber, byte mode, short 
recOffset, byte[] resp, short respOffset, short 
respLength) 


REDRSBS_BSS 


000101 


void rehabilitate ( ) 


REHA 


000110 


short seek (byte mode, byte[] patt, short pattOffset, 
short pattLength) 


SEEKB_BSS 


000111 


void select (short fid) 


SLOTS 


001000 


short select (short fid, byte[] fci, short fciOffset, 
short fciLength) 


SLCTS_BSS 


001001 


short status (byte [ ] fci, short fciOffset, short 
fciLength) 


STAT_BSS 


001010 


short updateBinary (short fileOffset, byte[] data, 
short dataOffset, short dataLength) 


UPDBS_BSS 


001011 


void updateRecord (short recNumber, byte mode, short 
recOffset, byte[] data, short dataOffset, short 
dataLength) 


UPDRSBS_BSS 


001100 



A.1 .2 SllVISystem methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static SIMView getTheSIMView ( ) 


GETS 


000001 



A. 1.3 SIIVIViewException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THITS 


000001 


SIMViewException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 



A.2 Sim.toolkit 



Class Name 


Acronyms 


Numbering on 5 bits 


Toolkit Const ants 


TKC 


00001 


Toolkit Interface 


TKI 


00010 
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Class Name 


Acronyms 


Numbering on 5 bits 


EditHandler 


EDH 


00011 


Envelope Handler 


ENH 


00100 


EnvelopeResponseHandler 


ERH 


00101 


MEProfile 


MEP 


00110 


ProactiveHandler 


PAH 


00111 


ProactiveResponseHandler 


PRH 


01000 


ToolkitRegistry 


TKR 


01001 


ViewHandler 


VWH 


01010 


Toolkit Except ion 


TKE 


01011 



A.2.1 ToolkitConstants 



Method Name 


Acronyms 


Numbering on 6 bits 


Constants 


CONS 


000001 



A.2.2 Toolkitlnterface methods 



Method Name 


Acronyms 


Numbering on 6 bits 


void processToolkit (byte event) 


PRTKB 


000001 



A.2.3 EditHandler methods 

The numbering of the EditHandler methods it will be done in the classes inherit it: EnvelopeResponseHandler, 
ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2.4 EnvelopeHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


byte getEnvelopeTag 


GENT 


000001 


byte getltemldentif ier 


GIID 


000010 


short getSecuredDataLength ( ) 


GSDL 


000011 


short getSecuredDataOf f set 


GSDO 


000100 


EnvelopeHandler getTheHandler ( ) 


GTHD 


000101 


short getTPUDLOffset 


GTPO 


000110 








Inherited Method Name: ViewHandler 






Byte 

compareValue (short valueOff set, byte [ ] compareBuf fer, s 

hort compareOf f set, short compareLength) 


GPRVS_BSS 


000111 


Short 

copy (byte [] dstBuf fer, short dstOff set, short dstLength 

) 


GOPY_BSS 


001000 


Short 

copyValue (short valueOff set, 

byte[] dstBuf fer, short dstOff set , short dstLength) 


CPYVS_BSS 


001001 


Byte 
f IndAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set) 


FAGRB_BS 


001010 


Byte f IndAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareO 
ff set, short compareLength) 


FAGRBBS_BSS 


001011 


Short 
FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FAGYBBS_BSS 


001100 


Short 
f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


FAGYB_BS 


001101 



ETSI 



3GPP TS 51.013 version 4.1.0 Release 4 



394 



ETSI TS 151 013 V4.1.0 (2003-12) 



Method Name 


Acronyms 


Numbering on 6 bits 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


001110 


Short 
GetLength {) 


GLEN 


001111 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010000 


Short 
GetValueLengthO 


GVLE 


010001 



A.2.5 EnvelopeResponseHandler methods 



IVIethod Name 


Acronym 


Numbering on 6 bits 


EnvelopeResponseHandler getTheHandler {) 


GTHD 


000001 


Void post (byte statusType) 


POSTB 


000010 


Void postAsBERTLV(byte statusType, byte tag) 


POSTBB 


000011 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA_BSS 


000100 


Void appendTLV (byte tag, byte value) 


APTLBB 


000101 


Void appendTLV (byte tag, byte [ ] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


000110 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


000111 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set, short value2Length) 


APTLBB_BSS 


001000 


Void clear () 


GLER 


001001 








Inherited Method Name: ViewHandler 






Byte 

compareValue ( short valueOffset, byte [ ] compareBuf fer, s 

hort compareOf f set , short compareLength) 


CPRVS_BSS 


001010 


Short 

Copy (byte [] dstBuf fer, short dstOff set, short dstLength 

) 


COPY_BSS 


001011 


Short 

CopyValue (short valueOffset, 

byte[] dstBuf fer, short dstOff set, short dstLength) 


CPYVS_BSS 


001100 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


FACRB_BS 


001101 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FAGRBBS_BSS 


001110 


Short 
FindAndCopy Value (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuf fer, short dstOff set, 
short dstLength) 


FACYBBS_BSS 


001 1 1 1 


Short 
f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


FACYB_BS 


010000 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010001 


Short 
GetLength () 


GLEN 


010010 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010011 


Short 
GetValueLength ( ) 


GVLE 


010100 



A.2.6 MEProfile methods 



Method Name 


Acronym 


Numbering on 6 bits 


static boolean check (byte index) 


CHECB 


000001 


static boolean check (byte [] mask, short offset, short 
length) 


CHEGBSS 


000010 
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Method Name 


Acronym 


Numbering on 6 bits 


static boolean check (short index) 


CHECS 


000011 


static short copy (short startOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


COPYS_BSS 


000100 


static short getValue (short indexMSB, short indexLSB) 


GVALSS 


000101 



A.2.7 ProactiveHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


GetTheHandler 


GTHD 


000001 


Init (byte type, byte qualifier, byte dstDevice) 


INITBBB 


000010 


InitDisplayText (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


INDTBB_BSS 


00001 1 


InltGetlnkey (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length) 


INGKBB_BSS 


000100 


InitGetlnput (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length, short minRespLength, short 
maxRespLength) 


INGPBB_BSSSS 


000101 


Byte send ( ) 


SEND 


000110 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA_BSS 


0001 1 1 


Void appendTLV (byte tag, byte value) 


APTLBB 


001000 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


001001 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


001010 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set, short value2Length) 


APTLBB_BSS 


001011 


Void clear 


GLER 


001100 








Inherited Method Name: ViewHandler 






Byte 

CompareValue (short valueOffset, byte [ ] compareBuf fer, sh 

ort compareOf f set , short compareLength) 


CPRVS_BSS 


001101 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLength) 


COPY_BSS 


001110 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


GPYVS_BSS 


001111 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, shor 
t compareOf f set ) 


FACRB_BS 


010000 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set, byte [ ] compareBuf fer, short compareOf 
fset, short compareLength) 


FACRBBS_BSS 


010001 


Short 
FindAndCopyValue (byte tag, byte occurence, short valueOf 
fset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


010010 


Short 
f indAndCopyValue (byte tag, byte [] dstBuffer, short dstOf 
fset) 


FACYB_BS 


010011 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010100 


Short 
GetLengthO 


GLEN 


010101 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010110 


Short 
GetValueLength () 


GVLE 


010111 
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A.2.8 ProactiveResponseHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


Short CopyAdditionalInf ormation (byte [ ] dstBuffer, 
short dstOffset, short dstLength) 


CPALBSS 


000001 


Short copyTextString (byte [ ] dstBuffer, short 
dstOffset) 


CPTS_BS 


000010 


Short getAdditionalInf ormationLength ( ) 


GTIL 


000011 


Byte getGeneralResult 


GTGR 


000100 


Byte get Itemldentif ier ( ) 


GTII 


000101 


Byte getTextStringCodingScheme ( ) 


GTGS 


000110 


Short getTextStringLength 


GTTL 


000111 


GetTheHandler 


GTHD 


001000 








Inherited Method Name: ViewHandler 






Byte 

CompareValue (short valueOff set, byte [ ] compareBuf fer, s 

hort compareOf f set, short compareLength) 


GPRVS_BSS 


001001 


Short 

Copy (byte [] dstBuffer, short dstOffset, short dstLength 

) 


COPY_BSS 


001010 


Short 

CopyValue (short valueOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


CPYVS_BSS 


001011 


Byte 
FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


FACRB_BS 


001100 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FACRBBS_BSS 


001101 


Short 
FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001110 


Short 
f indAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FACYB_BS 


001111 


Byte 

FindTLV (byte tag, byte occurrence) 


FINDBB 


010000 


Short 
GetLengthO 


GLEN 


010001 


Byte 
GetValueByte (short valueOffset) 


GVBYS 


010010 


Short 
GetValueLengthO 


GVLE 


010011 



A.2.9 ToolkitRegistry methods 



Method Name 


Acronyms 


Numbering on 6 bits 


AllocateTimer () 


ATIM 


000001 


changeMenuEntry (byte id, byte[] menuEntry, short 
offset, short length, byte nextAction, boolean 
helpSupported, byte iconQualif ier, short 
iconldentifier) 


CMETB_BSSBZBS 


000010 


clearEvent (byte event) 


CEVTB 


000011 


disableMenuEntry (byte id) 


DMETB 


000100 


enableMenuEntry (byte id) 


EMETB 


000101 


getEntry () 


GETY 


000110 


getPollInterval () 


GPOL 


000111 


initMenuEntry (byte [ ] menuEntry, short offset, short 
length, byte nextAction, boolean helpSupported, byte 
iconQualif ier, short iconldentifier) 


IMET_BSSBZBS 


001000 


isEventSet (byte event) 


lEVSB 


001001 


releaseTimer (byte timerldentif ier) 


RTIM 


001010 


requestPollInterval (short duration) 


RPOL 


001011 
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Method Name 


Acronyms 


Numbering on 6 bits 


setEvent (byte event) 


SEVTB 


001100 


setEventList (byte [ ] eventList, short offset, short 
length) 


SEVL BSS 


001101 



A.2.10 ViewHandler methods 

The numbering of the ViewHandler methods it will be done in the classes inherit it: EditHandler, EnvelopeHandler, 
ProactiveResponseHandler, ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 

A.2.11 ToolkitException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THITS 


000001 


ToolkitException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 
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Annex B (normative): 

Script file syntax and format description 

B.1 Syntax description 

Following is a syntax description in BNF. 

<statement list> ::= [ <statement> \n] + 

<statement> ::= <simple> I <switch> I <blank line> 

<simple> ::= <reset> I <init> I <command> I <remark> 

<reset> ::= RST 

<init> ::= INI <hexdata> 

<command> ::= CMD <hexdata> [ <response> ] ( <status> ) 

<response> ::= [ <hexdata> ] 

<status> ::= ( <hexdata> ) 

<remark> ::= REM <text lino 

<switch> ::= SWI { [<labelled list>] + } 

<labelled list> ::= <label> : \n <statement list> 

Description of syntax metalanguage : 

\n represents a linebreak 

[ X ] means x can appear optionally 

[ X ] + means 1 or more appearances of x 

X I y means x or y 

[ ] { } : (bold) these are characters that appear literally in the script files 

<text lino any character until the end of the line 

<blank lino a line containing no text is acceptable 

<hexdata> data written in hexadecimal, each byte separated from the following by a whitespace 

Each simple statement beginning with 3 characters different than the ones defined indicates another tool command, and 
shall be ignored by the parser if not recognized. 

' ' , ' \t ' : Can be used as separator 

A long statement can be broken into several lines by using the character '\' at the end of each line which is not the last 

one in the statement. 

For more details refer to the examples in B.3. 
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B.2 Semantics 

Following is the meaning of each of the statements: 

CMD : Sends an APDU Command to the card, including (optionally) the expected response data and also (optionally) 

the expected status words SWl, SW2. 
RST : Resets and powers on the card 
INI : Performs the terminal profile with the following data. Afterwards, it shall perform all the fetch and terminal 

response commands until there is no proactive session in progress. 
REM : Used for comments 
swi : Activates a switch condition. Every labelled list represents a list of statements to be executed, if the label 

matches the SW resulting from the previously executed command. 



Evaluation of expected response and status in the case of a CMD: 

<response> data within [. . .] has to be checked, it needs to be present for an outgoing command. Bytes written as XX 

shall not be checked by the APDU tool. 
<status> status contained within (...) has to be checked; when several status are valid they shall be separated by 

commas. Nibble written as X shall not be checked by the APDU tool. 

B.3 Example 

REM this is an example 

RST 

INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

REM Case 1 example 

CMD AO C2 00 00 00 (91 33 , 69 XX) 

REM Case 2 example 
CMD AO B6 00 00 07 \ 

[XX XX XX 55 55 XX 55] \ 

(91 33 , 67 XX) 

CMD AO B6 00 00 07 \ 
(91 33 , 67 XX) 

CMD AO CO IF \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \ 
02 OD CC CC CC CC CC CC CC CC CC CC CC CC CC ] \ 
(90 00) 

REM Case 3 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 

08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 

02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 

00 00 00 \ 

(90 00) 

REM Case 4 example with switch statement 

CMD 00 A4 04 00 10 \ 

AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 02 \ 
(61 XX, 6A 82) 



SWI 


{ 
































61 : 


XX: 
































CMD 


00 


CO 00 


00 


14 


\ 


























[IC 


1 AO OC 


) 00 


OC 


) 09 


00 


02 


FF 


FF 


FF 


FF 


89 


41 


04 


44 


\ 




02 


02 CC 


CC] 


\ 




























(9C 


1 00) 






























CMD 


AO 

3F 


A4 00 
00 


00 


02 


\ 
























6A 


32: 
































RST 
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) 



REM Case 5 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 

08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 

02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 
00 00 00 \ 
(6X 00) 



B.4 Style and formatting 



In order to show a common appearance all the scripts shall follow those format rules: 

start always with a 'RST' followed by an INI' command. 

The command, data to be checked and status to be checked shall be presented in the following order: 

CMD COMMAND [EXPECTED DATA] (EXPECTED STATUS) 

APDU shall be presented with command (CLA INS PI P2 P3) in one line and data (if present) in next line 
grouped 16 bytes per line (see example above). 

The expected data (if present) shall be presented in 16 bytes groups per line (see example above). 
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Annex C (normative): 
Default Prepersonalization 

C.1 General Default Prepersonalization 

This table shows the defauh prepersonalization, the file system and the files' content, that the test SIM cards shall 
contain unless otherwise stated. 



Name 


Identifier 


Default Value 


Special Features 


EFicciD 


2FE2 


OF FF FF FF FF FF FF FF FF FF 


This value is not compliant with 
3GPPTS 51.011 [3] 


EFiMsi 


6F07 


FF FF FF FF FF FF FF FF FF 


This value is not compliant with 
3GPPTS 51.011 [3] 


EFlp 


6F05 


01 FF FF FF 




EFkc 


6F20 


FF FF FF FF FF FF FF FF 07 




EFpLMNsel 


6F30 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 


FF 
FF 




EFhplmn 


6F31 


05 




EFACMmax 


6F37 


00 00 00 


Access condition UPDATE: CHV1 


EFssT 


6F38 


FF 3F C3 OF OC 00 FF OF 00 33 




EFacm 


6F39 


00 00 00 


Access condition UPDATE: CHV1 


EFpucT 


6F41 


FF FF FF 00 00 


Access condition UPDATE: CHV1 


EFbcch 


6F74 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 




EFacc 


6F78 


00 00 




EFppLMN 


6F7B 


FF FF FF FF FF FF FF FF FF FF FF 


FF 




EFloci 


6F7E 


FF FF FF FF 00 FO 00 00 00 FF 01 




EFad 


6FAD 


FF FF 




EFphase 


6FAE 


03 




EFpDN 


6F3B 


Default value in all the records 

FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 
FF 


Records: 5 


EFsMSP 


6F42 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF 


FF 
FF 
FF 


Records: 1 


EFlnd 


6F44 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 
FF 


Records: 1 


EFsMSS 


6F43 


FF FF 




EFsMs 


6F3C 


1"' record: 00 FF ... FF (length 176) 
2"^ record: 00 FF ... FF (length 176) 
3'^ record: 00 FF ... FF (length 176) 


Records: 3 


EFadn 


6F3A 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 
FF 


Records: 1 


EFccp 


6F3D 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF 


FF 




EFmsisdn 


6F40 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 
FF 


Records: 1 


EFsDN 


6F49 


FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF FF FF FF 
FF FF FF FF 


FF 
FF 


Records: 1 


EFsume 


6F54 


85 OC 54 4F 4F 4C 4B 49 54 20 54 

53 54 FF FF FF FF 


45 




EFcBMi 


6F45 


FF FF 




EFcBMID 


6F48 


10 80 




EFcBMIR 


6F50 


10 80 10 9F 




EF|M6 


4F20 


FF FF FF FF FF FF FF FF FF FF FF 





The default value for the CHVl shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state shall be 'disabled' 
during test applets execution. 
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C.2 Sim.Access.SimView test default prepersonalization 
C.2.1 DFsiMTEST (SIM Test) 

Identifier: '0319' 

C.2. 2 EFjNR (Transparent Never Read) 





Identifier: '6F01' Structure: transparent 


IVlandatory 




File size: 3 bytes | Update activity 


: low 


Access Conditions: 

READ NEVER 

UPDATE ALWAYS 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -3 


Test Data 


AA AA AA 


M 


3 bytes 



C.2. 3 EFtnu (Transparent Never Update) 





Identifier: '6F02' Structure: transparent 


IVlandatory 




File size: 3 bytes | Update activity 


: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -3 


Test Data 


55 55 55 


M 


3 bytes 



C.2. 4 EFtaru (Transparent Always Read and Update) 





Identifier: '6F03' Structure: transparent 


IVlandatory 




File size: 260 bytes | Update activity 


: low 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -260 


Test Data 


FF... FF 


M 


260 bytes 
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C.2.5 EFcNR (Cyclic Never Read) 



Identifier: '6F04' Structure: cyclic 


IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ NEVER 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.6 EFcNu (Cyclic Never Update) 



Identifier: '6F05' Structure: cyclic 


IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INCREASE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.7 EFcNic (Cyclic Never Increase) 



Identifier: '6F06 Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: 


high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE NEVER 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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C.2.8 EFcNiv (Cyclic Never Invalidate) 



Identifier: '6F07 Structure: cyclic 


IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE NEVER 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.9 EFcNRH (Cyclic Never Rehabilitate) 



Identifier: '6F08' Structure: cyclic 


IVIandatory 


Record length: 3 bytes Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE NEVER 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.10 EFcARu (Cyclic Always Read and Update) 



Identifier: '6F09' Structure: cyclic 


Mandatory 


Record length: 3 bytes Update activity: 


high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AA AA AA 


M 


3 bytes 
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C.2.1 1 EFlnr (Linear Fixed Never Read) 





Identifier: '6F0A' 


Structure: linear fixed IVIandatory 




Record length: 4 bytes 


1 Update activity: low 




Access Conditions: 




READ 


NEVER 




UPDATE 


ALWAYS 




INVALIDATE 


ALWAYS 




REHABILITATE ALWAYS 


Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 2 EFlnu (Linear Fixed Never Update) 





Identifier: '6F0B' 1 


Structure: linear fixed IVIandatory 


Record length: 4 bytes 


1 Update activity: low 


Access Conditions: 

READ ALWAYS 

UPDATE NEVER 

INVALIDATE ALWAYS 

REHABILITATE ALWAYS 


Logical 
Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 3 EFlaru (Linear Fixed Always Read and Update) 





Identifier: '6F0C' 


Structure: linear fixed IVIandatory 




Record length: 4 bytes 


1 Update activity: low 




Access Conditions: 




READ 


ALWAYS 




UPDATE 


ALWAYS 




INVALIDATE 


ALWAYS 




REHABILITATE ALWAYS 


Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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C.2.14 ER 



CINA 



(Cyclic Increase Not Allowed) 



Identifier: '6F0D' 


Structure: cyclic 


IVIandatory 


Record length: 3 bytes 


1 Update activity: high 


Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS (see note) 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 


NOTE: This file will be personalized in a way such that increase is not allowed, as indicated by the 
FCI byte 8, bit 7 (3GPP TS 51 .01 1 [3]: FCI structure of an EF returned by the SELECT 
command) 



C.2.15 EFjRAc (Transparent Read Access Condition CHV2) 



Identifier: '6F0E' 


1 


Structure 


;: transparent 


IVIandatory 


Record length: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
INVALIDATE 
REHABILITATE 


CHV2 
ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 



C.2.1 6 EFjiAc (Transparent Invalidate Access Condition CHV1 ) 



Identifier: 


6F0F' 




Structure 


;: transparent 


IVIandatory 


Recorc 


length 


: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 

INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 
ALWAYS 

CHV1 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 



£75/ 



3GPP TS 51.013 version 4.1.0 Release 4 



407 



ETSI TS 151 013 V4.1.0 (2003-12) 



C.2.17 EFciAc (Cyclic Increase Access Condition CHV2) 



Identifier: 


'6F10' 


1 


Structure: cyclic | 


IVIandatory 


Record length: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 

INCREASE 
INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 

CHV2 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GO GO 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.18 EFciAA (Cyclic Increase Access Condition ADM) 



Identifier: 


'6F11' 


1 


Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 
ADM 
ALWAYS 
ALWAYS 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



C.2.19 EFcNRi (Cyclic Never Rehabilitate Invalidated) 



Identifier: 


'6F12' 


1 


Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


1 


Update activity: 


ow 






Access Conditions: 
READ 
UPDATE 
INCREASE 
INVALIDATE 
REHABILITATE 


ALWAYS 
ALWAYS 
ALWAYS 
ALWAYS 
NEVER 




Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 GG GG 


M 


3 bytes 


2 


Test Data 


00 GG GG 


M 


3 bytes 



The file status shall be invalidated as defined in 3GPP TS 51.01 1 [3]. 
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Annex D (normative): 

sim.test.util package and loading, testing and cleaning script 

examples 

See attached files: 

Annex_D_SimTestUtil.zip 
Annex_D_Examples.zip 
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Annex E (normative): 
Test Area files 

See attached file: 

Annex_E_SourceCode.zip 
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Annex F (normative): 

AID numbering and acronyms for Framework tests 

F.1 Toolkit Installation Parameters (TIN) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Timer allocation 


TMAL 


000001 


Item identifier 


ITID 


000010 


Item position 


ITPO 


000011 


Access conditions 


ACCO 


000100 


Priority level 


PRLV 


000101 


Maximum length for each menu entry 


MLME 


000110 


Number of menu entries 


NBME 


000111 


IVIemory space 


MESP 


001000 



F.2 Minimum Handler Availability (MHA) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


EnvelopeResponseHandler 


ERHD 


000100 



F.3 Handler Integrity (HIN) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


RFU (EnvelopeResponseHandler) 


(ERHD) 


000100 



F.4 Applet Triggering (APT) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT PROFILE DOWNLOAD 


EPDW 


000001 


EVENT MENU SELECTION 


EMSE 


000010 


EVENT MENU SELECTION HELP REQUEST 


EMSH 


000011 


EVENT FORMATTED SMS PP ENV 


EFSE 


000100 


EVENT UNFORMATTED SMS PP ENV 


EUSE 


000101 


EVENT CALL CONTROL BY SIM 


ECCN 


000110 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000111 


EVENT TIMER EXPIRATION 


ETEX 


001000 


EVENT UNFORMATTED SMS CB 


EUCB 


001001 


EVENT EVENT DOWNLOAD MT CALL 


EDMC 


001010 


EVENT EVENT DOWNLOAD CALL CONNECTED 


EDCC 


001011 


EVENT EVENT DOWNLOAD CALL DISCONNECTED 


EDCD 


001100 


EVENT EVENT DOWNLOAD LOCATION STATUS 


EDLS 


001101 


EVENT EVENT DOWNLOAD USER ACTIVITY 


EDUA 


001110 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


EDIS 


001111 


EVENT EVENT DOWNLOAD CARD READER STATUS 


EDCR 


010000 


RFU (EVENT UNRECOGNIZED ENVELOPE) 


(EUEN) 


010001 
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Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT STATUS COMMAND 


ESTC 


010010 


EVENT EVENT DOWNLOAD LANGUAGE SELECTION 


EDLG 


010011 


EVENT EVENT DOWNLOAD BROWSER TERMINATION 


EDBT 


010100 


EVENT FORMATTED SMS CB 


EFCB 


010101 



F.5 Proactive Command Sending (PCS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


System Proactive commands 


SPCO 


000001 


Interaction with GSM commands 


IGCO 


000010 


Errors during proactive command sending 


EPCS 


000011 



F.6 Envelope Response Posting (ERP) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT CALL CONTROL BY SIM 


ECCN 


000001 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000010 


EVENT UNRECOGNIZED ENVELOPE 


EUEN 


000011 



F.7 Framework Security (FWS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Input data 


INDA 


000001 


Output data 


OUDA 


000010 



F.8 File System Context (FSC) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Initial Context 


INIT 


000001 


Context Preservation for Current File 


CUFI 


000010 


Context Preservation for Current Record 


CURE 


000011 



F.9 Exception Handling (EXH) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Hide exception to the mobile 


HEME 


000001 


Interaction with multi-triggering 


IMTG 


000010 



F.1 Other parts transferred to framework from API (API) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


A handler is a temporary JCRE Entry Point object 


HEPO 


000001 


Transaction 


TRAN 


000010 


Timer Id between Applets 


TMID 


000011 
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Annex G (normative): 
Configuration Parameters File 



This file describes all the mandatory and optional parameters that are used in order to create the loading script(s) for one 
test area. The configuration parameters file contains the values for the parameters needed in order to generate the 
loading and cleanup scripts. 

The name of the parameters file will be <test area reference>_<n>.par . 

The number <n> is associated with the loading/cleanup script number, i.e. API_2_TKR_ SEVL_BSS_l.par is used to 
generate API_2_TKR_ SEVL_BSS_l.ldr etc. 



G.1 Syntax 

The general syntax for this file will be: 

<file> ;;= <section>+ 

<section> ::= <section heacling> <line break> <section bocly> 

<section heacling> ; ;= ' [ <name> ' ] 

<section bocly> ;;= <parameter assignment>+ 

<parameter assignment> ;;= <name> '— <value> <line break> 

Where '+' indicates one or more repetitions of the previous syntax element. 

Any text included between the symbol ' ; ' and the end of line is considered a comment and ignored by parsing tools. 

Empty values are considered valid. They are used to indicate that an optional value is not present. 

Names of sections, names of parameters and values are case-sensitive. 

Blank spaces and Tabs between tokens are allowed and will be ignored by the parser. 

When values represent a sequence of bytes, they are expressed in hexadecimal format, where every 2 digits represent 
one byte. Blank space between bytes is optional. 

Example: 



; comment 






[Sectionl] 






Parameterll 


= 00 11 22 33 




Parameterl2 


= 0101 ; another 


comment 


[Section2] 






Parameter21 


= vvwwxxyyzz 
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G.2 File Contents and Organization 

Parameters in this file are organized in the following sections: 



[CONVERT] 


Conversion parameters used during conversion (i.e. CAP file generation) 


[INSTALL(load)] 


Parameters used by tlie Install for Load command 


[LOAD] 


Parameters used by the Load command 


[INSTALL(install)] 


Parameters used by the Install for Install command 



All sections may appear only once in the file, except for the "INSTALL(install)" section. If that section appears more 
than once, it will apply to different applet instances, in sequence. 

G.2.1 Default values, order and processing 

The ordering of the parameters and the sections is relevant, since parameter names may be repeated and apply to 
different applets. 

When one single parameter is repeated within one section, it refers to different applets. The value of the «* appearance 
of the parameter applies to applet n. 

When one section is repeated (INSTALL(install)), then the n appearance of the section applies to applet n. 
Parameter/value pairs which are found in one appearance of the section are valid for the subsequent applets as long as 
they are not overridden. For example, first INSTALL(install) may contain all values for parameters, whereas the 
subsequent INSTALL(install) sections may only contain parameters whose values change. 

If one required parameter is missing from one section, the last defined value of this parameter in a previous section of 
the same file will be used. 

G.2.2 CONVERT Section 

These parameters allow configuration of the conversion process of the Java class file(s) into one CAP file. 



Parameter 


Description 


PackageAID 


AID of the package 


PackageName 


Fully qualified name of the package 


PackageVersion 


Version of the package 


AppletClassAID 


AID of the applet 


AppletClassName 


Name of the applet 



G.2.3 INSTALL(load) Section 



Here are the parameters to be included in the Install(Load) command (as specified in TS 23.048 [8] ). 



Parameter 


Description 


PackageAID 


AID of the package 


PackageNonVolatileMemSize 


Non Volatile memory space (in bytes) required for package loading 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 



G.2.4 LOAD Section 

Here are the parameters to be included in the Load command (as specified in TS 23.048 [8] ). 



Parameter 


Description 


MaxLoadCommandDataLength 


IVIaximum length of the data provided in the load command (P3 
parameter of the LOAD APDU embedded in the command packet) 
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G.2.5 INSTALL(install) Section 



Here are the parameters to be included in the Install(Install) command (as specified in 3GPP TS 23.048 [8]). 



Parameter 


Description 


PackageAID 


AID of the package 


AppletClassAID 


AID of the applet 


InstanceAID 


AID of the instance of the applet 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 


AccessDomain 


Specify the SIM files that may be accessed by the applet and the 
operations allowed on these files. This parameter includes the 
Access Domain Parameter (ADP) and Access Domain Data (ADD) 


PriorityLevel 


Priority level of the Toolkit applet instance 


MaxNumberOfTimers 


IVIaximum number of timers allowed for this applet instance 


MaxMenuEntryTextLength 


Maximum text length for a menu entry 


MaxNumberOfMenuEntries 


Maximum number of menu entries allowed for this applet instance 


MenuEntriesPositionldentifier 


For each menu entry: Position and identifier of that menu entry 


AppletSpecificParameters 


Parameters specific to the applet 



The applet shall be installed with install(install and make selectable) command. 



G.3 Full example 



[CONVERT] 

PackageAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 00 
PackageName = sim. test . access . api_l_svw_upclrbs 
PackageVersion = 1.0 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 
AppletClassName = API_1_SVW_UPDRBS_1 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
AppletClassName = API_1_SVW_UPDRBS_2 

[INSTALL (load) ] 

PackageNonVolatileMemSize = 0D27 
; InstallationNonVolatileMemSize = 0400 
; InstallationVolatileMemSize = 0000 

[LOAD] 
MaxLoadCommandDataLength = 6C ; max value 

[INSTALL (install) ] 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 
InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 
InstallationNonVolatileMemSize = 0400 
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InstallationVolatileMemSize = 0000 
AccessDomain = 00 
PriorityLevel = FF 
MaxNumberOfTimers = 00 
MaxMenuEntryTextLength = 10 
MaxNumberOfMenuEntries = 01 
MenuEntriesPositionldentif ier = 0001 
AppletSpecif icParameters = 

[INSTALL (install) ] 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
InstallationNonVolatileMemSize = 0200 
InstallationVolatileMemSize = 0000 
MenuEntriesPositionldentif ier = 0002 



rest of INSTALL (install) parameters are taken from previous INSTALL (install) ... 
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Annex H (informative): 
Change history 



The table below indicates all changes that have been made to the present document since drafting work began. 



Change history 


Date 


TSG# 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 


2000-10 


- 










Draft presented at 73 #1 6 




0.2.0 


2000-12 


TP-10 


TP-000208 








Presented to TSG-T #1 for information 


0.2.0 


1.0.0 


2001-01 


- 


- 








Input to T3 #1 7 resulting from T3 ad hoc #24 


1.0.0 


1.1.0 


2001-03 


- 










Document presented for approval at 13 #18 


1.1.0 


1.2.0 


2001-03 


TP-11 


TP-010041 








Document presented for approval to TSG-T #1 1 
(identical in technical content to v1 .2.0) 


1.2.0 


2.0.0 


2001-03 












As approved at TSG-T #1 1 (identical in technical content 
to V2.0.0) 


2.0.0 


7.0.0 


2001-05 












Correction to date on cover page / headers 


7.0.0 


7.0.1 


2001-06 


TP-12 


TP-010105 


A001 


- 


F 


Corrections to the API Test plan, addition of the test area 
files and modification of the until package 


7.0.1 


7.1.0 


2001-09 


TP-13 


TP-010206 


A002 


- 


F 


Update API Test plan and Test Area Files 


7.1.0 


7.2.0 


2001-11 


TP-14 


TP-010241 


A003 


- 


F 


Specification for framework part 


7.2.0 


7.3.0 


A004 


- 


F 


API part 


2002-03 


TP-15 


TP-020073 


004 


- 


F 


Testing Framework Update 


7.3.0 


7.4.0 


2002-03 












Files for Annexes D and E added, Editorial correction 
performed in 6.3.2.3.3 column 9(1- Applet triggered) 


7.4.0 


7.4.1 


2002-09 


T3#24 










Reference [14] changed as TS 101 220 v3.0.0 was 
withdrawn. 


7.4.1 


7.4.2 


2002-09 


TP-17 










Specification upgraded to release 99 without any 
changes. The technical content is identical to the 
previous version 7.4.2 


7.4.2 


8.0.0 


2002-12 


TP-18 


TP-020285 


A005 




F 


Update of 1 1.13 Specification for Release 99 


8.0.0 


8.1.0 


2003-03 


TP-19 


TP-030026 


A006 




F 


Corrections on 1 1 .13 Specification 


8.1.0 


4.0.0 


A007 




F 


Upgrade of 1 1 .13 Specification to Release 4 


2003-04 




Editorial modification: replacement of Annex E source 
code file. 


4.0.0 


4.0.1 


2003-12 


TP-22 1 TP-030258 | 002 | | F 


Essential corrections 


4.0.1 


4.1.0 
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